HTTP请求
1. 简介
1.1 功能简介
HTTP 请求节点用于在智能助手Pro 中配置 API 调用,向指定 URL 发送请求,获取并解析返回数据,供下游节点使用。
1.2 应用场景
通过配置 HTTP 请求节点,用户无需添加按钮并配置前端事件,可直接在智能助手Pro 中通过该节点发起 HTTP 请求,实现与外部系统的数据交互。
1.3 预期效果
以查询物流信息为例,当提交物流单号后,自动触发 Pro 通过 HTTP 请求节点配置的物流信息查询接口,快速识别并返回物流信息,效果如下所示:
1.4 版本说明
本功能为付费高级功能,需简道云企业版及以上版本可用(试用版可进行试用)。详情参见:官网定价。
2. 设置步骤
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。