# HTTP 请求节点

# 节点说明

HTTP 请求节点作为AI工作流的重要组成部分，提供了通过 HTTP 协议与外部服务进行双向数据通信的能力。用户可通过该节点灵活调用各类外部接口，实现跨系统间的信息获取、传输与同步。

该节点支持常见的 HTTP 请求方法（如 GET、POST、PUT、DELETE 等），并可配置请求参数、请求头、身份验证及请求体内容，以适应多样化的集成场景。同时，节点内置超时控制与自动重试机制，保障了数据传输过程的稳定性和完整性。

HTTP 请求节点主要承担以下几类功能：

外部数据接入：从第三方 API 或服务中实时获取所需信息，如查询天气、调用用户资料、获取实时汇率等。
数据发送与提交：将本地或流程中产生的数据推送给外部系统，例如提交订单信息、发送报表数据等。
远程数据更新：修改外部系统中已有的数据记录，例如变更订单状态、完善用户资料等。
外部数据移除：请求删除外部服务中的指定数据，如清理测试账户、撤销已提交的记录等。

# 节点配置

在使用 HTTP 请求节点实现数据获取、提交等功能时，通常需要配置 API、路径参数、请求体参数、请求参数、请求头、鉴权、请求体等参数。

# API

配置 API 请求地址和方法，支持以下请求方法以适应不同场景：GET、POST、HEAD、PUT、PATCH 、DELETE
在填写 API 请求地址时，可通过输入 {{ 插入变量，以实现路径或参数的动态配置。此外，为确保连接的稳定与安全，建议优先使用完整的域名（如 https://api.example.com）进行访问，直接使用 ip:port形式可能因安全策略导致请求被拦截。

# 路径参数

路径参数是上面 API 配置的地址中的花括号部分参数，例如下面地址中的 name 和 id 就是路径参数，需要在这里进行配置，以匹配 API 地址。
```
/message/{{name}}/{{id}}?mode=edit
```

# 请求体参数

请求体参数，是配置好供下面请求体里使用的变量参数，在请求体里以花括号 {{}} 的形式来使用。

# 请求参数

请求参数是附加在 URL 后面的键值对，用于向服务器传递额外的信息。例如，在搜索请求中，可以通过请求参数传递搜索关键词。

# 请求头

请求头包含客户端的信息，如 User-Agent、Accept、Content-Type 等。通过配置请求头，可以指定客户端的类型、接受的数据格式等信息。

# 鉴权

通过配置鉴权信息，可以确保请求的安全性，防止未授权的访问，支持 Bearer Token 和自定义鉴权：
- Bearer Token：输入 Token 值，通常用于 OAuth2 等认证方式。
- 自定义鉴权：配置自定义的认证信息，参数如下：
  - Key：认证键。
  - Value：认证值。
  - Add To：选择将认证信息添加到请求头（Header）或查询参数（Query）。

# 请求体

请求体是 POST 请求中包含的数据，可以是表单数据、JSON 数据等。根据不同的请求类型和数据格式，可以选择相应的请求体格式，例如 form-data、x-www-form-urlencoded、raw text、JSON 等。

# 超时设置

超时时间定义了HTTP请求节点运行的最长允许耗时。一旦请求处理时间超过此设定值，系统将自动判定为运行超时并终止该次请求。合理配置超时设置，能够有效避免因外部服务响应缓慢或网络异常导致的工作流长时间阻塞，提高工作流的响应速度。
当前设定中，HTTP请求节点的超时时间默认值为30秒（即半分钟）。用户可根据实际网络条件与目标服务的响应特性，在配置界面中调整此数值，最大可延长至180秒（即3分钟）。

# 重试次数

当HTTP请求节点运行超时或遇到异常时，系统默认会自动重试2次。用户可根据具体业务需求和对服务稳定性的要求，在配置中调整重试策略，最大可设置为重试10次。

# 输出

输出变量包括响应体、状态码和响应头。

# 异常忽略

启用该功能后，在工作流执行过程中，即使此节点因超时、网络错误等原因运行失败，流程也不会因此中断，系统将自动跳过本节点并继续执行后续的下游节点。
若下游节点引用了本节点的输出变量，系统将使用您在此节点配置中预先设定的默认输出内容作为替代值。

# 使用示例

开始节点

工作流的起始节点，本示例需要配置输入参数 space_id。

HTTP请求节点

用于调用接口，可以添加路径参数。
API：请求地址为 https://api.xxx.cn/v1/space/published_bots_list，方法为 GET。
请求参数：定义参数 space_id，并引用开始节点的输入参数 space_id。
请求头：需要设置以下参数：
- Content-Type：固定值 application/json。
- Authorization：用于验证客户端身份的访问令牌。
鉴权：本示例无需鉴权。
请求体：本示例设置为 none。

设置为 JSON 时，如果引用的变量为 string 类型，需要使用双引号""包裹变量。
超时设置、重试次数、输出：本示例保持默认配置

# 常见问题

# Q1：HTTP 请求超时如何处理？

当遇到HTTP请求超时问题时，可以通过调整超时时间配置来优化。系统默认超时时间为30秒，用户可根据实际网络环境和目标服务的响应速度，在0-180秒范围内灵活设置。
建议根据服务端的平均响应时间合理配置，避免因设置过短导致频繁超时，或设置过长影响工作流整体效率。

# Q2：HTTP 请求失败如何应对?

针对HTTP请求失败的情况，系统提供了重试机制进行容错处理。默认情况下，当请求超时或出现异常时，系统会自动重试2次。
用户可根据业务场景的稳定性要求，将重试次数调整至最多10次。这一机制能够有效应对网络波动、服务暂时不可用等临时性问题。

# Q3：HTTP 请求安全防护如何做？

为确保HTTP请求的安全性，系统支持多种鉴权方式配置。用户可在请求节点中设置API密钥、Bearer Token等身份验证信息，确保每次请求都携带合法的身份凭证。
建议使用HTTPS协议进行加密传输，避免敏感信息在传输过程中被窃取或篡改，同时建议使用域名访问而非IP地址，以规避安全策略拦截风险。

← 文档提取文本 →