HTTP请求

1. 简介

1.1 功能简介

HTTP 请求节点用于在智能助手Pro 中配置 API 调用,向指定 URL 发送请求,获取并解析返回数据,供下游节点使用。

1.2 应用场景

通过配置 HTTP 请求节点,用户无需添加按钮并配置前端事件,可直接在智能助手Pro 中通过该节点发起 HTTP 请求,实现与外部系统的数据交互。

1.3 预期效果

以查询物流信息为例,当提交物流单号后,自动触发 Pro 通过 HTTP 请求节点配置的物流信息查询接口,快速识别并返回物流信息,效果如下所示:

1.4 版本说明

本功能为付费高级功能,需简道云企业版及以上版本可用(试用版可进行试用)。详情参见:官网定价

2. 设置步骤

新建 智能助手Pro 后,将自动进入设计画布,配置好 触发节点 后,即可进行后续执行节点的配置。

2.1 添加节点

根据业务需求,在已有节点后添加一个 HTTP 请求节点。

2.2 配置请求地址

2.2.1 请求方法

支持以下两种请求方式

  • GET:用于获取数据,参数 (Query or Params) 可拼接在 URL 中,例如: ?code=123
  • POST:用于发送、提交数据,可以向指定的 URL 提交需处理的数据。

注:POST 请求方式仅支持 https 协议,不支持 http 协议。

2.2.2 URL

1)URL 是请求的服务器地址。使用 GET 方法时,需将参数拼接在 URL 中,并支持插入字段给参数赋值。

2)URL 中支持插入的字段及其解析值格式如下:

字段名称

解析值格式

单行文本

文本

多行文本

文本

数字

数字

单选按钮组

文本

复选框组

文本(逗号拼接)

下拉框

文本

下拉复选框

文本(逗号拼接)

日期时间

时间戳,例如“2025-09-16T16:00:00.000Z”

流水号

文本

提交时间

时间戳,例如“2025-09-16T16:00:00.000Z”

更新时间

时间戳,例如“2025-09-16T16:00:00.000Z”

触发时间

时间戳,例如“2025-09-16T16:00:00.000Z”

微信昵称

文本

微信 OpenId

文本

扩展字段

文本

注: URL 长度取决于配置服务器,如果过长将被截断,导致部分数据参数传输失败。

2.3 配置请求头/体

  • 使用 GET 方法时:仅可设置「请求头」参数;
  • 使用 POST 方法时:可设置「请求头」和「请求体」参数。

2.3.1 请求头

每个请求头参数需设置「键」和「值」,「值」中支持插入的上游节点字段与【2.2.2 URL】处一致。

注:每个 HTTP 请求中最多可添加 50 个请求头。

2.3.2 请求体

根据调用接口的不同,请求体参数的设置如下表所示:

格式

设置方式

无请求体

无需设置

TEXT

支持插入上游节点字段

form-data

每个请求体参数需设置「键」和「值」,「值」中支持插入的上游节点字段与【2.2.2 URL】处一致。

x-www-form-urlencoded

注:每个 HTTP 请求中最多可添加 50 个请求体。

2.4 选择返回值格式

返回值支持两种格式:JSON 和 TEXT,两种返回值格式对应的解析结果如下表:

返回值格式

解析结果

JSON

可解析为多种类型,包括:

  • 文本
  • 数字
  • 文本数组
  • 子表单(子表单内同样可解析文本、数字或文本数组)

TEXT

始终解析为文本

2.5 设置请求超时时间

支持自定义请求超时时长,最长可设置 600 秒,超时后将报错提醒。

2.6 调试接口

配置完成后需进行接口调试,解析返回数据结构,以便下游节点调用。

注:返回数据最大仅支持 256 KB。

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验