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 提交需处理的数据。
 

注:
1)两种请求方式仅支持 https 协议,均不支持 http 协议。
2)请求地址不支持配置简道云 API 接口地址。
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  | 

注:
1)每个 HTTP 请求中最多可添加 50 个请求体;
2)请求体暂不支持 JSON 格式。
2.4 选择返回值格式
返回值支持两种格式:JSON 和 TEXT,两种返回值格式对应的解析结果如下表:
返回值格式  | 解析结果  | 
JSON  | 可解析为多种类型,包括: 
  | 
TEXT  | 始终解析为文本  | 
2.5 设置请求超时时间
支持自定义请求超时时长,最长可设置 600 秒,超时后将报错提醒。
2.6 调试接口
配置完成后需进行接口调试,解析返回数据结构,以便下游节点调用。

注:返回数据最大仅支持 256 KB。
3. 注意事项
3.1 常见错误码及修改建议
错误码  | 报错内容  | 修改建议  | 
100134  | URL 格式无效或是无法解析  | 请检查请求地址是否正确  | 
100135  | 协议不匹配  | 请检查请求地址是否正确  | 
100136  | 目标端口无效 报错场景:目标接口使用「IP + 端口」访问时,使用了 80 或 443 以外的端口  | 请尝试使用其他端口或检查网络与安全设置  | 
100137  | 无法访问目标服务器  | 请检查请求地址是否正确  | 
100138  | 客户端 IP 地址无效或被禁止访问 报错场景:目标接口使用「IP + 端口」访问时,使用了内网 IP(实际需使用公网 IP)  | 请验证客户端 IP 格式是否正确,并确认该 IP 是否被误加入黑名单或限制访问的策略中  | 
100140  | HTTP 请求调用异常  | /  | 
100141  | 返回体超过 256 KB  | /  | 
100146  | 节点执行超时  | 点击「重试」按钮重新执行此节点  | 

400-111-0890
在线咨询