HTTP Request 是 n8n 里最通用的节点——任何提供 REST API 的服务都能接。官方没有内置集成的服务（比如国内的飞书、企业微信），HTTP Request 就是你的万能接口。
四种认证方式
| 方式 | 适用场景 | 配置 |
|---|---|---|
| Header Auth | API Key 放 Header | Authorization: Bearer sk-xxx |
| Query Auth | API Key 放 URL 参数 | ?api_key=xxx |
| OAuth2 | 第三方登录授权 | Client ID + Secret + Redirect |
| Basic Auth | 用户名密码 | username:password Base64 |
实际使用中 Header Auth 最常见。在 Credentials 里创建一个 Header Auth 类型，填好 Name 和 Value，所有节点都能复用。
分页处理：拉取全量数据
大部分 API 单次最多返回 100 条，拿全量数据需要翻页。n8n 的 HTTP Request 节点内置了 Pagination 支持：
Pagination 配置:
Type: Offset-Based
Complete When: Response Is Empty
Page Size: 100
Offset Parameter: offset
Limit Parameter: limit
如果 API 用 cursor 分页（比如 Slack API），选 Response Contains Next URL：
Pagination 配置:
Type: Response Contains Next URL
Next URL: {{ $response.body.response_metadata.next_cursor }}
Complete When: {{ !$response.body.response_metadata.next_cursor }}
n8n 会自动循环请求直到拉完所有页。
重试与超时
生产环境调外部 API 一定要配重试，防止网络抖动导致整个工作流失败：
HTTP Request 节点 Settings:
Timeout: 30000 # 30 秒超时
Retry On Fail: true
Max Retries: 3
Wait Between Retries: 1000 # 毫秒
Continue On Fail: true # 失败不阻断后续节点
实战：对接飞书 Webhook 发消息
飞书机器人用 Webhook 推消息，只需一个 POST 请求：
// HTTP Request 节点配置
// Method: POST
// URL: https://open.feishu.cn/open-apis/bot/v2/hook/你的token
// Body (JSON):
{
"msg_type": "interactive",
"card": {
"header": {
"title": { "content": "{{ $json.title }}", "tag": "plain_text" },
"template": "blue"
},
"elements": [{
"tag": "markdown",
"content": "{{ $json.content }}"
}]
}
}
飞书机器人不需要 OAuth，Webhook URL 本身就是鉴权。适合报警通知、日报推送这类单向场景。
调试技巧
调 API 遇到问题时，打开 HTTP Request 节点的 Options → Full Response，n8n 会返回完整的 status code、headers 和 body，而不是只返回 body。排查 401/403 鉴权问题时特别有用。
Expression 里可以直接引用环境变量存放 API Key，避免硬编码：
{{ $env.FEISHU_WEBHOOK_URL }}
{{ $env.THIRD_PARTY_API_KEY }}
