HTTP 请求节点允许用户通过 HTTP 协议发送请求到外部服务，实现数据的获取、提交和交互。支持多种 HTTP 请求方法，并允许用户配置请求参数、请求头、鉴权信息、请求体等，以满足不同的数据交互需求。此外，HTTP 请求节点还提供了超时设置、重试机制，确保请求的可靠性和数据的正确处理。 HTTP 请求节点的作用如下： * **数据获取**：从外部服务获取数据，例如从 API 获取用户信息、天气数据等。 * **数据提交**：向外部服务提交数据，例如提交表单数据等。 * **数据更新**：更新外部服务中的数据，例如更新用户信息、修改订单状态等。 * **数据删除**：删除外部服务中的数据，例如删除用户账户、删除订单等。 ## 节点配置 在使用 HTTP 请求节点实现数据获取、提交等功能时，通常需要配置 API、请求参数、请求头、鉴权、请求体等参数。为了简化这一配置过程，提高开发效率，HTTP 请求节点支持导入 cURL 功能，开发人员可以快速将 cURL 命令中的参数导入到 HTTP 请求节点。 | **配置项** | **说明** | | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | API | 配置 API 请求地址和方法，支持以下请求方法：* **GET**：用于请求从外部服务获取数据，例如调用 API 获取用户信息、天气数据等。* **POST**：用于向服务器提交数据，例如提交表单。* **HEAD**：类似于 GET 请求，但服务器不返回请求的资源主体，只返回响应头。* **PATCH**：用于在请求-响应链上的每个节点获取传输路径。* **PUT**：用于向服务器上传资源，通常用于更新已存在的资源或创建新的资源。* **DELETE**：用于请求服务器删除指定的资源。配置API请求地址时，可以使用变量来动态指定参数，通过输入{{即可唤出并使用该变量。 | | 请求参数 | 请求参数是附加在 URL 后面的键值对，用于向服务器传递额外的信息。例如，在搜索请求中，可以通过请求参数传递搜索关键词。 | | 请求头 | 请求头包含客户端的信息，如 User-Agent、Accept 等。通过配置请求头，可以指定客户端的类型、接受的数据格式等信息。 | | 鉴权 | 通过配置鉴权信息，可以确保请求的安全性，防止未授权的访问，支持 Bearer Token 和自定义鉴权：* **Bearer Token**：输入 Token 值，通常用于 OAuth2 等认证方式。* **自定义鉴权**：配置自定义的认证信息，包括：* **Key**：认证键。* **Value**：认证值。* **Add To**：选择将认证信息添加到请求头（Header）或查询参数（Query）。 | | 请求体 | 请求体是 POST 请求中包含的数据，可以是表单数据、JSON 数据等。根据不同的请求类型和数据格式，可以选择相应的请求体格式，例如 form-data、x-www-form-urlencoded、raw text、JSON 等。 | | 超时设置 | 通过配置超时设置，可以避免长时间等待，提高系统的响应速度。 | | 重试次数 | 重试次数设置允许在请求失败时自动重试，提高请求的成功率。 | | 输出 | 输出变量包括响应体、状态码和响应头。 | | 异常忽略 | 支持**异常忽略**功能。开启此功能后，如果试运行工作流时此节点运行失败，工作流不会中断，而是继续运行后续下游节点。如果下游节点引用了此节点的输出内容，则使用此节点预先配置的默认输出内容。 | ## 示例 例如通过 HTTP 请求节点调用扣子的[查看智能体列表](https://www.coze.cn/docs/developer_guides/published_bots_list)接口，可以获取指定空间发布到 Agent as API 渠道的智能体列表。  节点配置如下： | **节点类型** | **说明** | **示例** | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ | | 开始节点 | 工作流的起始节点，本示例需要配置输入参数space\_id，用于指定要查看的空间。 |  | | HTTP 请求节点 | 用于调用查看智能体列表接口，获取指定空间发布到 Agent as API 渠道的智能体列表，需要根据[查看智能体列表](https://www.coze.cn/docs/developer_guides/published_bots_list)的接口要求配置：* API：请求地址为https://api.coze.cn/v1/space/published\_bots\_list，方法为 GET。* 请求参数：定义参数space\_id，并引用开始节点的输入参数space\_id。* 请求头：需要设置以下参数：* Content-Type：固定值**application/json。*** Authorization：用于验证客户端身份的访问令牌，本示例以个人访问令牌为例，取值格式为 Bearer \$Access\_Token*。*个人访问令牌可参考[添加个人访问令牌](https://www.coze.cn/open/docs/developer_guides/pat)。* 鉴权：本示例无需鉴权。* 请求体：本示例设置为**none**。设置为**JSON**时，如果引用的变量为 string 类型，需要使用双引号""包裹变量。具体示例，请参考["[720712042] Body is not json" 错误如何处理？](https://www.coze.cn/open/docs/guides/http_node#87a72228)。* 超时设置、重试次数、输出：本示例保持默认配置。 |  | | 结束节点 | 选择返回变量模式，定义 output 参数，引用 HTTP 请求节点的输出参数 body。 |  | ## 常见问题 ### 如何解决 HTTP 请求超时问题？ 可以通过配置超时设置来解决 HTTP 请求超时问题。合理设置超时时间，可以避免请求长时间等待。 ### 如何处理 HTTP 请求失败的情况？ 可以通过配置重试次数设置来处理 HTTP 请求失败的情况。设置重试次数，可以提高请求的成功率。 ### 如何确保 HTTP 请求的安全性？ 可以通过配置鉴权信息来确保 HTTP 请求的安全性。 ### 如何处理"[720712042] Body is not json" 错误？ 设置**请求体**为 **JSON** 格式时，如果请求体为不符合 JSON 格式规范，将出现 "[720712042] Body is not json" 错误。为解决此问题，请仔细检查请求体满足以下要求： * 请求体内容为有效的 JSON 结构。 * 如果请求体中引用了变量，当变量为 string 类型时，需使用双引号 "" 包裹变量。