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 等。
选择 JSON 格式时，你需要单击 Edit JSON，才能输入请求体。

超时设置

超时时间指节点运行的最大耗时，如果超过此时长，则判断为节点运行超时。通过配置超时设置，可以避免长时间等待，提高工作流的响应速度。
默认情况下，HTTP 节点的超时时间默认为 120s，即 2 分钟；最长可设置为 600 秒，即 10 分钟。

重试次数

节点运行超时或异常时，默认重试 3 次，最大可设置为 10 次。

输出

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

异常忽略

支持异常忽略功能。开启此功能后，如果试运行工作流时此节点运行失败，工作流不会中断，而是继续运行后续下游节点。如果下游节点引用了此节点的输出内容，则使用此节点预先配置的默认输出内容。

开始节点

工作流的起始节点，本示例需要配置输入参数space_id，用于指定要查看的空间。

HTTP 请求节点

用于调用查看智能体列表接口，获取指定空间发布到 Agent as API 渠道的智能体列表，需要根据查看智能体列表的接口要求配置：

• API：请求地址为https://api.coze.cn/v1/space/published_bots_list，方法为 GET。
• 请求参数：定义参数space_id，并引用开始节点的输入参数space_id。
• 请求头：需要设置以下参数：
  • Content-Type：固定值 application/json。
  • Authorization：用于验证客户端身份的访问令牌，本示例以个人访问令牌为例，取值格式为 Bearer $Access_Token*。​*个人访问令牌可参考添加个人访问令牌。
• 鉴权：本示例无需鉴权。
• 请求体：本示例设置为 none。
  设置为 JSON 时，如果引用的变量为 string 类型，需要使用双引号""包裹变量。具体示例，请参考如何处理"[720712042] Body is not json" 错误？。

  说明

  在 JSON 格式的请求体中引用变量时，你可以输入 {来引用变量。

• 超时设置、重试次数、输出：本示例保持默认配置。

结束节点

选择返回变量模式，定义 output 参数，引用 HTTP 请求节点的输出参数 body。