首先完成“第4课:添加逻辑、条件和错误处理”即可解锁本课程。转到上一课

简介

在 n8n 中,大多数工作流可以使用原生节点构建——每个节点都是对特定服务的封装。但实际的业务自动化很少只停留在这些边界内。你会遇到需要的服务没有专用节点、其节点缺少特定端点,或者需要以内置节点难以处理的方式转换数据的情况。这时 HTTP Request 节点和 Code 节点就派上用场。本课聚焦这两种工具:如何调用任意外部 API,以及在 n8n 的可视化节点不够用时如何进入自定义 JavaScript 或 Python。

通过 HTTP Request 调用外部 API

HTTP Request 节点是你的通用连接器。它开箱就支持 REST,并可与任何暴露 HTTP 端点的服务配合使用——即使那些没有 n8n 节点。

对一个公共 API 的典型 GET 请求在 n8n 的节点配置中看起来是这样的:

bash
curl -X GET "https://api.example.com/v1/customers/42" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/json"

在 HTTP Request 节点 UI 中,方法(Method)设置为 GET,粘贴 URL,并在 Headers 下添加两个头部。节点会将响应体作为 JSON 对象返回,后续节点可以通过 n8n 表达式如 `$json.fieldName` 引用。

对于发送数据的 POST 请求,切换方法,将 Send Body 设置为 JSON,并提供请求体。例如,在外部 CRM 中创建一个记录:

json
{
"name": "Acme Corp",
"email": "contact@acme.com",
"source": "n8n-workflow"
}
图示展示数据从触发器节点流向 HTTP Request 节点,再流向外部 API,随后返回下游 n8n 节点的过程

身份验证选项很重要。许多商业 API 使用 Bearer 令牌、OAuth2 或作为查询参数传递的 API 密钥。n8n 将这些都作为凭据类型,确保你不在节点中硬编码密钥——通过 Credentials 下拉框引用它们。对于使用自定义认证方案的服务,设置 Authentication 为 Generic Credential Type,并提供引用存储凭据的头部名称和值。

何时使用 Code 节点

内建节点覆盖常见的 80% 需求——通过 SplitInBatches 进行循环,使用 Set 节点进行数据映射,使用 IF 节点进行条件逻辑。剩下的 20% 是 Code 节点发挥作用的地方:复杂的字符串解析、统计计算、调用辅助库、n8n 的 Date 节点在日期运算上处理起来比较笨拙的场景,或任何将五个可视化节点串联起来比用十行代码更慢且更难读的情况。

Code 节点有两种模式。JavaScript 模式在 n8n 的 Node.js 运行时中原生运行,能够完全访问已安装的 npm 包。Python 模式使用 Pyodide 或根据你的 n8n 设置使用托管的 Python worker。

一个常见用例:在通过 webhook 收到数据后对混乱数据进行清理再保存。设想一个表单以混合大小写并带有尾随空格的国家名发送过来,你需要用于外部查询的 ISO 国家代码。

javascript
const items = $input.all();
const countryMap = {
"united states": "US",
"united kingdom": "GB",
"vietnam": "VN",
"germany": "DE"
};
return items.map(item => {
const raw = (item.json.country || "").toLowerCase().trim();
const code = countryMap[raw] || "UNKNOWN";
return {
json: {
...item.json,
country_code: code
}
};
});

在 Python 模式下的等效实现几乎完全相同,只是在字典访问和列表推导的语法上进行切换。同一个节点同时支持两种语言——选择团队更熟悉的那一种。

决策流程图,显示在何种情况下使用本地节点、HTTP 请求节点或 Code 节点

将 HTTP 请求与 Code 组合在一个工作流中

真正的强大之处在于将它们组合起来。一个常见模式:Code 节点转换传入数据,HTTP 请求节点调用外部服务进行信息丰富化,第二个 Code 节点对响应进行后处理,结果流向最终目标。

示例流程——发票丰富化:

javascript
// Code node 1: normalize vendor names
const items = $input.all();
const cleaned = items.map(i => ({
json: {
invoice_id: i.json.id,
vendor: i.json.vendor_name.toLowerCase().replace(/[^a-z0-9]/g, "-")
}
}));
return cleaned;

然后一个 HTTP 请求节点在 `GET /vendors/{vendor}` 访问你的会计 API 以获取付款条款。最后一个 Code 节点合并结果:

javascript
const items = $input.all();
return items.map(i => ({
json: {
invoice_id: i.json.invoice_id,
vendor: i.json.vendor,
payment_terms: i.json.payment_terms || "NET30",
flagged: !i.json.payment_terms
}
}));

第三个节点还会标记出付款条款为空的发票——如果用可视化节点实现,这将需要额外的 IF 节点来处理的小逻辑。

常见错误

在开始构建之前值得指出的几个陷阱。首先,切勿将凭据直接放在节点正文或 URL 中——始终使用 n8n 的凭据系统,否则密钥会出现在工作流导出和版本控制中。其次,HTTP Request 节点默认是“JSON 响应”——如果你的 API 返回 XML 或纯文本,请切换 Response Format,否则你会看到解析错误。第三,Code 节点一次处理一个批次的项;如果你需要在执行之间保持状态(计数器、缓存等),那应该使用数据库或 n8n 的静态数据,而不是 Code 节点。第四,在 Code 节点 JavaScript 中要小心使用 `await`——它是受支持的,但需要包裹在 async 函数中,这会让许多初次使用者迷惑。

Summary

HTTP Request 节点为 n8n 提供了一种普遍的与任意 HTTP API 进行通信的方式。Code 节点填补了可视化逻辑变得冗长或不可能的空白。上述模式——外部 API 调用、数据转换,以及两者的结合——大致覆盖你在生产环境中要构建的九成左右的自定义集成。掌握这两种节点类型,你就不再局限于某个特定服务节点所能提供的功能。

课后练习

课程检查点

巩固所学知识,获取作业反馈。

0/1
已回答 · 0/1
第5课:使用 API 和自定义代码节点