HTTP 调用节点

节点说明

HTTP 调用节点用于通过标准 HTTP 协议访问外部 API 接口，支持 GET、POST、PUT、DELETE、PATCH 等请求方式。通过配置请求参数、鉴权方式和请求超时设置，可灵活接入第三方服务，实现与外部系统的数据交互。

节点配置

HTTP 调用节点主要包含以下模块：输入、请求配置、请求参数、输出。

1. 输入模块

用于配置传入 HTTP 请求的参数。字段名为接口所需字段的名称，字段值可引用其他节点的输出结果。

例如：

2. 请求配置模块

点击齿轮按钮可展开详细配置：

• 请求方式：支持 GET、POST、PUT、DELETE、PATCH 五种 HTTP 方法。

• 请求地址：输入目标请求的 URL 地址。

• 鉴权：用于配置接口访问权限，支持以下三种方式：

  1. 无：不进行鉴权。
  2. API-Key：系统提供三种填写方式：
  • 基础：用户直接填写 API Key，系统将其写入 header 中。
  • Bearer：用户填写 API Key，系统自动添加 Bearer 前缀。
  • 自定义：用户可自定义 Header 名称与 API Key 值，系统将其完整写入 header 中。

• 超时时长：设置接口请求的最长等待时间（单位为秒），如设置为 1s 表示接口在 1 秒内未响应即超时。

3. 请求参数模块

用于设置 HTTP 请求的相关参数，包括 Params 和 Headers 两部分：

• Params：URL 查询参数，常用于 GET 请求的查询条件。
• Headers：HTTP 请求头信息，例如认证信息、内容类型等。

参数值可通过双花括号 引用输入中存在的变量，例如，其中 input 为输入模块中定义的字段。

4. 输出模块

请求返回结果结构如下：

{
  "output": {
    "data": {},
    "status": 200,
    "errorMsg": ""
  }
}

• data：接口返回的原始数据，调用失败时为空。
• status：接口状态码，200-299 表示成功。
• errorMsg：接口调用失败时的错误信息。

通过配置 HTTP 调用节点，用户可以轻松接入任意开放接口，将外部数据纳入智能体流程中，增强流程的可扩展性与智能化水平。