【n8n教程】：n8n API Node节点，自动化工作流管理

关注

原创最新推荐文章于 2026-04-29 12:53:18 发布 867 阅读 AI 写同款· GEO 优化 ›

【n8n教程】：掌握n8n流程逻辑，构建复杂自动化工作流在n8n中构建自动化工作流时，你不仅需要连接不同的应用程序，还需要根据不同的条件做出决策、处理多个数据流、循环处理数据以及处理可能出现的错误。这正是流程逻辑（Flow Logic）的用武之地。阅读详情

【n8n教程】：n8n API Node节点，自动化工作流管理

n8n API Node 是一个强大的节点，允许您通过n8n本身的REST API在工作流中执行各种自动化操作。无论是管理凭证、控制工作流、追踪执行历史，还是进行安全审计，这个节点都是您的得力助手。本教程将带领初学者从零开始，深入理解n8n API Node的四大操作类别、核心参数配置，并通过实际案例演示如何构建一个完整的工作流审计系统。

点击获取最新AI资讯、n8n工作流、开发经验分享

什么是n8n API Node？

节点的基本定义

n8n API Node 是一种特殊的核心节点，它允许您在n8n工作流中直接调用n8n平台本身的REST API。想象一下，如果说其他节点是用来连接外部服务的工具，那么n8n API Node就是用来管理n8n自身的工具。

这个节点的独特之处在于：

自我管理：可以在工作流运行时创建、修改、删除其他工作流
权限控制：安全地管理凭证和认证信息
数据追踪：查询工作流执行历史和状态
系统审计：生成安全审计报告，了解系统使用情况

它能做什么

n8n API Node支持四大主要操作类别，覆盖了n8n平台管理的核心功能：

操作类别	主要功能	常见用途
Audit（审计）	生成安全审计报告	检查系统风险、识别弃用工作流
Credential（凭证）	创建、删除、获取凭证	程序化管理认证信息
Execution（执行）	查询、删除工作流执行记录	追踪运行历史、清理数据
Workflow（工作流）	创建、激活、修改工作流	动态生成自动化流程

四大操作详解

1. 审计操作（Audit）：系统安全卫士

什么是"生成审计"？

生成审计操作会扫描您的整个n8n实例，识别潜在的安全风险和系统问题。它无需任何参数，但提供两个关键选项来定制审计范围。

核心配置参数

类别选择（Categories）：选择要审计的风险类型

可选项包括：
✓ Credentials（凭证风险）- 审查凭证管理
✓ Database（数据库）- 检查数据存储
✓ Filesystem（文件系统）- 验证文件访问
✓ Instance（实例）- 检查系统配置
✓ Nodes（节点）- 审查节点使用情况

弃用工作流天数（Days Abandoned Workflow）：指定多少天没有运行的工作流应被视为"弃用"

默认值：90天
含义：如果一个工作流90天没有被执行，审计报告会将其标记为可能需要清理

实际使用场景

假设您是n8n平台管理员，需要：

检查是否有过期的凭证暴露风险
识别长期未使用、可以清理的工作流
了解节点使用情况是否合规

您就可以使用生成审计操作，通过选择相关类别快速获得完整的安全报告。

2. 凭证管理（Credential）：安全的钥匙库

凭证的作用

凭证（Credential）是存储在n8n中的敏感信息，用于认证您与外部服务的连接。比如：

API密钥（GitHub API、OpenAI API）
OAuth令牌（Google、Slack）
数据库密码
用户名和密码对

三个核心操作

创建凭证（Create Credential）

参数说明：
1. Name（名称）
   - 输入：凭证的描述性名称
   - 例如：my_github_api_prod

2. Credential Type（凭证类型）
   - 输入：githubApi、notionApi、slackApi等
   - 内置类型取决于您安装的节点

3. Data（数据）
   - 输入：JSON对象，包含该凭证类型所需的所有属性
   - 例如：{"token": "ghp_xxx", "username": "john"}
   - 提示：可通过"获取凭证模式"查看所需格式

删除凭证（Delete Credential）

参数说明：
- Credential ID（凭证ID）
  需要提供要删除的凭证的唯一标识符

获取凭证模式（Get Credential Schema）

参数说明：
- Credential Type（凭证类型）
  输入类型名称（如githubApi），系统返回该类型所需的JSON结构

安全最佳实践

✓ 永远不要在工作流代码中硬编码凭证
✓ 使用n8n的加密凭证管理器存储敏感信息
✓ 定期审计哪些工作流使用了哪些凭证
✓ 为不同的服务使用不同的凭证（避免单点故障）
✓ 长期未使用的凭证应及时删除

3. 执行追踪（Execution）：运行历史的档案库

什么是执行记录？

当一个工作流运行时，n8n会创建一条执行记录，记录下这次运行的所有细节：输入数据、中间结果、最终输出、错误信息等。

核心操作

获取单次执行（Get Execution）

参数说明：
- Execution ID（执行ID）
  输入想要查询的执行记录的唯一标识符

高级选项：

- Include Execution Details（包含执行详情）
  开启：返回完整的执行数据（包括节点输出）
  关闭：只返回基本信息（执行时间、状态）

获取多个执行记录（Get Many Executions）

参数说明：
1. Return All（返回全部）
   - 开启：获取所有执行记录
   - 关闭：需要设置数量限制

2. Limit（限制数量）
   - 输入：返回多少条记录
   - 例如：100

3. Filters（过滤条件）
   - 按工作流过滤（From list、By URL、By ID）
   - 按状态过滤（Error、Success、Waiting）

删除执行记录（Delete Execution）

参数说明：
- Execution ID（执行ID）
  输入要删除的执行记录ID
  
应用场景：清理不需要的历史记录以节省存储空间

实战例子

假设您想追踪某个关键工作流的运行情况：

步骤1：使用"获取多个执行记录"，设置过滤条件
      - 选择指定工作流
      - 只筛选状态为"Error"的记录

步骤2：检查这些失败的执行
      - 查看错误信息
      - 分析失败原因

步骤3：根据问题修复工作流
      - 更新节点配置
      - 测试修复效果

4. 工作流管理（Workflow）：自动化流程的灵魂

工作流是什么？

工作流是一系列节点的组合，这些节点按特定的连接方式组织，自动执行某个业务流程。

工作流的四种基本操作

激活和停用（Activate / Deactivate）

选择工作流的方式：
1. From list（从列表选择）
   - 直接从下拉菜单中选择

2. By URL（通过URL）
   - 输入工作流的完整URL

3. By ID（通过ID）
   - 输入工作流的唯一标识符（通常是URL末尾的字符串）

获取工作流（Get Workflow）

用途：以JSON格式获取工作流的完整定义
返回内容：节点、连接、设置等所有配置信息

删除工作流（Delete Workflow）

参数：选择要删除的工作流（方式同上）
警告：删除操作不可撤销！请谨慎使用。

创建工作流（Create Workflow）

参数说明：
Workflow Object（工作流对象）
必需字段：
{
  "name": "My First Workflow",           // 工作流名称
  "nodes": [...],                         // 节点数组
  "connections": {...},                   // 连接关系
  "settings": {...}                       // 工作流设置
}

详见：n8n API参考文档

更新工作流（Update Workflow）

参数说明：
1. Workflow（选择工作流）
2. Workflow Object（更新的配置对象）

用途：
- 添加新节点
- 修改现有连接
- 更新工作流设置

获取多个工作流（Get Many Workflows）

参数说明：
1. Return All（返回全部）
2. Limit（返回数量限制）

过滤选项：
- Return Only Active Workflows（仅显示激活的工作流）
- Tags（按标签筛选）
  输入：逗号分隔的标签列表

凭证配置：前置准备工作

为什么需要认证？

n8n API Node 必须能够证明您有权访问您的n8n实例。这就需要认证信息（通常是API令牌）。

获取API令牌

在自托管n8n中：

步骤1：进入n8n界面
      左侧菜单 → Settings → API

步骤2：创建新API令牌
      点击"Create New API Token"按钮
      
步骤3：配置令牌
      - 取消勾选"Non-Expiration"使令牌永不过期（或保留过期期限）
      - 点击"Save"

步骤4：复制令牌
      令牌只会显示一次，务必立即保存到安全位置

在n8n API Node中使用令牌

操作步骤：
1. 创建新Credential
2. 选择"n8n API"类型
3. 输入参数：
   - URL：您的n8n实例地址（如 http://localhost:5678）
   - API Token：刚才复制的令牌
4. 点击"Create"保存

SSL相关注意事项

n8n API Node 不支持SSL连接。如果您的n8n服务器需要SSL连接，有两个解决方案：

方案一：使用HTTP Request节点代替n8n API Node

HTTP Request节点提供了SSL证书配置选项
需要手动构建API调用，但更灵活

方案二：在代理层面处理SSL

使用nginx、Apache等反向代理处理SSL
n8n实例通过HTTP内部通信

完整案例：构建工作流审计系统

案例需求

假设您管理着一个n8n实例，希望自动执行以下任务：

定期生成安全审计报告
识别未使用的凭证
检查弃用工作流
将结果发送到指定邮箱

工作流JSON代码

以下是一个完整的、可直接导入n8n的工作流示例：

{
  "name": "n8n Instance Audit & Report",
  "active": false,
  "nodes": [
    {
      "parameters": {
        "rule": {
          "interval": [
            {
              "days": 7
            }
          ]
        }
      },
      "id": "c0f5f0f1-0000-0000-0000-000000000000",
      "name": "Schedule Trigger",
      "type": "n8n-nodes-base.scheduleTrigger",
      "typeVersion": 1,
      "position": [
        250,
        300
      ]
    },
    {
      "parameters": {
        "method": "POST",
        "url": "=http://localhost:5678/api/v1/audit/generate",
        "authentication": "predefinedCredentialType",
        "nodeCredentialType": "n8nApi",
        "options": {}
      },
      "credentials": {
        "n8nApi": {
          "id": "n8n_api_credential",
          "name": "n8n Instance Credential"
        }
      },
      "id": "n8n-api-node-audit",
      "name": "Generate Audit Report",
      "type": "n8n-nodes-base.n8n",
      "typeVersion": 1,
      "position": [
        450,
        300
      ]
    },
    {
      "parameters": {
        "operations": "getMany",
        "returnAll": true,
        "filters": {
          "returnOnlyActiveWorkflows": false,
          "tags": ""
        }
      },
      "credentials": {
        "n8nApi": {
          "id": "n8n_api_credential",
          "name": "n8n Instance Credential"
        }
      },
      "id": "get-workflows-node",
      "name": "Get All Workflows",
      "type": "n8n-nodes-base.n8n",
      "typeVersion": 1,
      "position": [
        650,
        300
      ]
    },
    {
      "parameters": {
        "jsCode": "let activeCount = 0;\nlet inactiveCount = 0;\n\nconst workflows = $input.all();\n\nfor (const workflow of workflows) {\n  if (workflow.active) {\n    activeCount++;\n  } else {\n    inactiveCount++;\n  }\n}\n\nreturn {\n  totalWorkflows: workflows.length,\n  activeCount: activeCount,\n  inactiveCount: inactiveCount,\n  timestamp: new Date().toISOString()\n};"
      },
      "id": "code-analyze-workflows",
      "name": "Analyze Workflows",
      "type": "n8n-nodes-base.code",
      "typeVersion": 1,
      "position": [
        850,
        300
      ]
    },
    {
      "parameters": {
        "fromEmail": "automation@example.com",
        "toEmail": "admin@example.com",
        "subject": "Weekly n8n Audit Report",
        "textOnly": false,
        "htmlEmail": "=<h2>n8n Weekly Audit Report</h2>\n<p>Generated: {{ $json.timestamp }}</p>\n<ul>\n  <li>Total Workflows: {{ $json.totalWorkflows }}</li>\n  <li>Active Workflows: {{ $json.activeCount }}</li>\n  <li>Inactive Workflows: {{ $json.inactiveCount }}</li>\n</ul>"
      },
      "id": "send-email-report",
      "name": "Send Email Report",
      "type": "n8n-nodes-base.emailSend",
      "typeVersion": 1,
      "position": [
        1050,
        300
      ]
    }
  ],
  "connections": {
    "Schedule Trigger": {
      "main": [
        [
          {
            "node": "Generate Audit Report",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Generate Audit Report": {
      "main": [
        [
          {
            "node": "Get All Workflows",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Get All Workflows": {
      "main": [
        [
          {
            "node": "Analyze Workflows",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Analyze Workflows": {
      "main": [
        [
          {
            "node": "Send Email Report",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {}
}

导入和配置步骤

第一步：复制工作流JSON

1. 复制上面的完整JSON代码
2. 进入n8n主界面
3. 左上角菜单 → Import Workflow
4. 粘贴JSON代码
5. 点击Import

第二步：配置凭证

1. 打开新导入的工作流
2. 找到所有带警告符号的节点（通常是红色！）
3. 对每个节点：
   - 点击node配置
   - Credentials部分点击"Create New"
   - 填入您的n8n API信息
   - 保存

第三步：配置邮件发送

1. 编辑"Send Email Report"节点
2. 连接您的邮件服务（SMTP、Gmail等）
3. 设置发件人和收件人邮箱

第四步：激活并测试

1. 点击"Save"保存工作流
2. 点击"Execute Workflow"进行测试
3. 检查执行日志确保各步骤成功
4. 如无问题，点击"Activate"启用自动化

工作流的运作流程

每周定时触发
    ↓
调用n8n Audit API 生成审计报告
    ↓
获取所有工作流列表
    ↓
用Code节点分析统计
    ↓
生成报告并发送邮件

常见问题解答

Q1：n8n API Node和HTTP Request节点有什么区别？

n8n API Node：

专门为n8n API设计
自动处理n8n API的认证
提供了结构化的操作选项
易于初学者使用

HTTP Request Node：

通用HTTP请求工具
需要手动配置请求细节
支持SSL
更灵活，可调用任何REST API

使用建议：调用n8n自身API用前者，调用外部API用后者。

Q2：API令牌应该如何安全保管？

最佳实践：
✓ 令牌必须立即保存到密钥管理系统或密码管理器
✓ 不要在代码中硬编码令牌
✓ 定期轮换（更新）令牌
✓ 为不同的场景使用不同的令牌
✓ 过期时间设置应遵循安全策略（通常30-90天）
✓ 发现泄露立即撤销

Q3：可以在一个工作流中调用另一个工作流吗？

是的，使用 Execute Workflow 节点而非n8n API Node。这样更简洁，数据传递也更清晰。

总结

何时使用n8n API Node

✓ 需要程序化管理工作流（创建、修改、删除）
✓ 进行系统审计和合规性检查
✓ 批量管理凭证
✓ 查询执行历史用于分析和调试
✓ 构建n8n的自动化管理平台

官方文档
 n8n系列教程

收录于

n8n教程

标签

#ai #人工智能 #ai编程 #AIGC

n8n系列（2）核心概念：工作流、节点与执行在n8n中，工作流是一系列连接在一起的节点，用于定义自动化任务的执行流程。每个工作流都有一个明确的起点（通常是触发器节点）和一个或多个终点（执行特定操作的节点）。工作流可以被视为一个可视化的"流程图"，数据在节点之间流动，每个节点对数据进行特定的处理或操作。节点是n8n工作流中的基本构建块，代表特定的功能或操作。每个节点都有特定的输入和输出，可以接收数据、处理数据并将结果传递给下一个节点。n8n提供了400多种预构建的节点，覆盖了各种服务和功能。阅读详情

【n8n教程】：n8n API Node节点，自动化工作流管理

【n8n教程】：n8n API Node节点，自动化工作流管理

什么是n8n API Node？

节点的基本定义

它能做什么

四大操作详解

1. 审计操作（Audit）：系统安全卫士

什么是"生成审计"？

核心配置参数

实际使用场景

2. 凭证管理（Credential）：安全的钥匙库

凭证的作用

三个核心操作

安全最佳实践

3. 执行追踪（Execution）：运行历史的档案库

什么是执行记录？

核心操作

实战例子

4. 工作流管理（Workflow）：自动化流程的灵魂

工作流是什么？

工作流的四种基本操作

凭证配置：前置准备工作

为什么需要认证？

获取API令牌

在n8n API Node中使用令牌

SSL相关注意事项

完整案例：构建工作流审计系统

案例需求

工作流JSON代码

导入和配置步骤

工作流的运作流程

常见问题解答

Q1：n8n API Node和HTTP Request节点有什么区别？

Q2：API令牌应该如何安全保管？

Q3：可以在一个工作流中调用另一个工作流吗？

总结

何时使用n8n API Node

相关推荐