跳到主要内容

Http请求节点

Http请求节点允许通过 HTTP 协议发送请求到外部服务，实现数据获取、业务处理等功能。支持多种 HTTP 请求方式（GET、POST、PUT、DELETE），并支持设置请求头、请求参数等。

Http请求节点

应用场景​

Http请求节点可广泛应用于以下业务场景：

  • 数据获取：从外部系统查询并获取业务所需的数据，如调用第三方 API 获取天气、汇率、库存信息等；
  • 数据提交：向外部服务器提交数据，如提交表单数据、用户行为日志、订单信息等；
  • 数据更新：通过 PUT 或 PATCH 请求对外部系统中的数据进行更新，如更新用户资料、修改状态等；
  • 调用业务功能：触发外部系统的业务接口，执行如发送短信、邮件通知、发起支付、启动流程等操作；
  • 异步处理：结合回调接口，用于异步任务处理的发起与结果通知。

节点配置详解​

输入变量配置​

在节点右侧配置面板中，可以设置该 Http 节点的输入变量：

  • 左侧输入框：填写变量名；
  • 右侧下拉框：选择变量来源节点，变量必须来自当前节点之前的节点，不能引用后续或并行节点。
输入变量配置

API 地址配置​

配置 HTTP 请求的地址与请求方式：

  • 左侧下拉框：选择请求方法（GET、POST、PUT、DELETE）；
  • 右侧文本框：填写请求地址。支持使用 {{domainURL}} 来设置为当前域名。
API配置

请求参数配置​

配置发送请求时的 URL 参数：

  • 左侧填写参数名称；
  • 右侧填写参数值。支持：
    • 常量：直接填写具体的字符串或数值；
    • 变量：使用 {{变量名}} 的形式引用之前节点的输出变量。
请求参数配置

请求头配置​

设置 HTTP 请求头参数：

  • 左侧填写请求头名称；
  • 右侧填写请求头的值，同样支持常量和变量引用。
请求头配置

💡 系统会自动添加当前登录用户的 X-Access-Token 和租户标识 X-Tenant-Id 到请求头中。

请求体配置​

配置请求体内容：

  • 可以选择不同的请求体类型（如 JSON、form-data 等），对应的 Content-Type 请求头会自动设置；
  • 可在请求体中填写内容，并使用 {{变量名}} 引用上下文变量。
请求体类型配置

⚠️ 所有参数均支持 系统变量 和输入变量。

输出变量配置​

Http 节点默认输出以下两个变量：

  • statusCode：HTTP 响应的状态码；
  • body：HTTP 响应体内容。

此外，也可通过自定义方式，从 body 中提取特定字段作为输出变量：

自定义输出变量