集中式自动化管理器 API - n8n 工作流

• 自动化专家： 需要对大量 n8n 模板进行程序化控制和编排的人员。


• 开发者： 构建需要与 n8n 后端交互的外部工具（如这里提到的 Raycast 扩展）或自定义界面的开发者。


• DevOps 工程师： 需要一个 API 端点来检查已部署的 n8n 工流实例状态（激活/非激活）的工程师。


• 系统集成工程师： 需要一个统一的 n8n 触发点来动态触发各种专业 n8n 工流的集成工程师。

管理多个复杂的 n8n 工流可能很棘手，特别是当外部系统需要以编程方式与它们交互时。这个专业的 n8n 工流通过提供一个单一的、高安全性的 Webhook n8n 触发器端点，解决了这种编排难题。这个独特的 n8n 模板支持两个关键功能：1) 通过 POST 请求动态执行任何目标 n8n 工流；2) 通过 GET 请求检索 n8n 实例中任何工流的详细状态信息。该工作流利用原生的 n8n API 节点，确保了高效且安全的后端通信，使其成为扩展 n8n 自动化基础设施的任何人的必备工具。

该自动化始于经过头部凭证认证的 Webhook n8n 触发器，它在 workflow-manager 路径上监听。后续逻辑根据使用的 HTTP 方法进行分支：

1. 工流执行 (POST 请求)

1. 映射： “将 Webhook 请求映射到字段” n8n 节点从 URL 查询参数中提取目标 workflowId 以及将传递给目标 n8n 工流的输入 body 数据。


2. 执行： 调用强大的“执行工流” n8n 节点，使用动态提供的 workflowId。它被配置为等待子工流完成，确保同步操作。


3. 响应： 如果成功，“返回成功消息”节点会返回被执行的 n8n 工流的输出。如果执行失败，流程将通过“返回工作流执行问题”处理错误。

2. 信息检索 (GET 请求)

1. 参数映射： “映射参数” n8n 节点提取 mode、workflowId 和 includedWorkflows 查询参数。


2. ID 检查： “Does workflowId Exist”（工流ID是否存在）n8n 节点检查是否请求了特定的工流 ID。

1. 输出格式化： 所有获取到的数据汇集到“full mode” If（如果）n8n 节点，该节点检查 mode 参数。

要部署此集中式管理 n8n 工流，请遵循以下步骤：

1. 导入： 复制提供的 JSON 并将其作为新的 n8n 工流导入到您的实例中。


2. Webhook 认证： “Webhook” n8n 触发器需要头部认证。在 n8n 中创建一个新的 Header Auth 凭证，将 Authorization 设置为头部名称，将 Bearer YOURSECRETKEY 设置为强密码值。


3. n8n API 凭证： API 检索分支需要访问您的 n8n 实例 API。创建一个“n8n API”凭证（通常根据您的实例设置需要 API 密钥或用户凭证），并将其附加到所有四个 n8n API 节点上（Get specific workflowid, get all inactive workflows, get all active workflows, get all workflows）。


4. 激活： 确保工流已激活。记下 Webhook URL（例如 https://your.n8n.instance/webhook/workflow-manager）。


5. 使用示例 (POST)： 要使用 ID 为 123 的工流执行操作，请向 .../workflow-manager?workflowId=123 发送一个 POST 请求，并带上一个 JSON 正文。


6. 使用示例 (GET)： 要获取所有激活工流的摘要，请向 .../workflow-manager?includedWorkflows=active 发送一个 GET 请求。

Webhook (n8n 触发器)： n8n 工流的入口点，配置为头部认证，支持在 /workflow-manager 路径上接收 GET 和 POST 请求。
Map webhook request to fields (Set n8n 节点)： 对于执行路径至关重要。它将查询参数 workflowId 和 POST 请求正文 (workflowInputData) 映射到下一个 n8n 节点可访问的变量中。
Execute Workflow (n8n 节点)： 编排逻辑的核心。它使用表达式动态定位另一个 n8n 工流，并等待其执行完成。这对于集中控制至关重要。
n8n (API n8n 节点)： 在所有 GET 分支中用于与 n8n 实例的内部 API 交互。操作包括 get 特定工流以及根据 activeWorkflows 状态参数过滤列表，从而实现对 n8n 模板的管理。
Does workflowId Exist (If n8n 节点)： 判断传入的 GET 请求是针对单个工流还是 n8n 工流的过滤列表。
Included Workflows (Switch n8n 节点)： 根据 includedWorkflows 查询参数（active、inactive 或 all）路由列表获取请求，确保发出正确的 n8n API 调用。

• Map key workflow info (Set n8n 节点)： 在“摘要”模式下使用，用于精简详尽的 n8n API 响应，仅提供关键元数据（名称、ID、状态），以获得更简洁、更快速的响应。