有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

简介

HTTP Request 连接器作为 HTTP 客户端,可以发起 HTTP 请求并将得到的响应作为消息传递给下一个组件。

配置说明

根据您创建应用的时间不同,HTTP Request 连接器配置也不相同,具体如下:
配置方法
适用场景
配置入口
在2021年9月2日前创建的应用
在新建连接配置页面进行基本配置和高级配置
在2021年9月2日及之后创建的应用
直接在右侧弹出的配置界面中即可进行基本配置和高级配置
在2022年4月8日及之后创建的应用
配置连接 > 配置请求信息
与方案一相比,方案二和方案三的优化内容如下:
方法二优化内容:此项优化不影响原有和现有应用的配置和使用,只是在配置操作上进行了优化,更方便客户填写对应信息。
方法三优化内容:HTTP Request 连接器支持连接配置的统一管理。

方法一(2021年9月2日前创建的应用)

参数介绍

基本配置:HTTP Request 连接器基本配置中包括描述、请求域名、请求协议、请求端口、最大重定向次数以及公共请求路径,其中请求域名、请求协议、请求端口、最大重定向次数、公共请求路径为必填项。



高级配置:HTTP Request 连接器高级配置中包括安全网关配置,用于内网域名/IP 请求。


上述连接器配置参数相关描述如下表所示:
参数
数据类型
描述
是否必填
默认值
请求域名
string
对应的请求域名
请求协议
string
下拉框选择请求协议 HTTPS/HTTP
HTTPS
请求端口
string
请求端口,1-65535,默认443,与请求协议联动,HTTP 协议默认会是80
443
最大重定向数
int
重定向次数,最小值0,最大值1
1
公共请求路径
string
请求的公共路径,多次请求的路径中相同的部分可配置为公共请求路径
/
安全网关名称
string
直接请求内网域名/IP 时,需要绑定安全网关

配置说明

HTTP Request 操作配置包括基本配置、高级配置两项:


基础配置参数描述
高级配置参数描述
参数
参数类型
描述
是否必填
默认值
请求路径
string/表达式
用于指定发送请求的路径
/
请求方法
string
下拉单选指定发送请求的方法,全集为:GET、POST、PUT、PATCH、DELETE、HEAD
GET
请求头
表达式
用于指定发送请求的请求头,结构为:dict<string,list>
请求参数
表达式
用于指定发送请求的请求参数,结构为:dict<string,string>
请求体
string/表达式
用于指定发送请求的请求体,非 GET、HEAD 方法是设置,支持字面量和表达式,默认是消息的 payload


参数
参数类型
描述
是否必填
默认值
消息属性
string
下拉框选择输出消息绑定的属性,HTTP Request 只支持绑定 payload
payload
类型选择
string
下拉框选择输出消息 payload 绑定的数据类型,包括 message 内置数据类型和自定义数据类型
数据消费模式
string
下拉框选择是否对消息数据进行持久化处理:
repeatable:默认处理方式,消息数据可在一次触发中持续重复使用
non-repeatable:数据一次性消费,用于大文件数据的流式高效处理,暂时支持 JSON 数组类型,其超过5M时建议选择该模式
repeatable


方法二(2021年9月2日及之后创建的应用)

参数介绍

基本配置:HTTP Request 连接器基本配置中包括请求 URL、请求协议、请求方法、请求头、请求参数、最大重定向次数以及请求超时时间,其中请求URL、请求方法、最大重定向次数为必填项。
高级配置:HTTP Request 连接器高级配置中输出消息绑定自定义数据类型,可用于自定义输出消息数据类型。绑定安全网关,用于内网域名/IP 请求。



配置说明

HTTP Request 操作配置包括基本配置、高级配置两项:


基础配置参数描述
高级配置参数描述
参数
参数类型
描述
是否必填
默认值
请求URL
string/表达式
用于指定发送请求的URL
/
请求方法
string
下拉单选指定发送请求的方法,全集为:GET、POST、PUT、PATCH、DELETE、HEAD
GET
请求头
表达式
用于指定发送请求的请求头,结构为:dict<string,list
>
请求参数
表达式
用于指定发送请求的请求参数,结构为:dict<string,string>
最大重定向数
init/表达式
用于指定发送请求的请求体
1
请求超时时间
string/表达式
用于设置请求超时时间
1

参数
参数类型
描述
是否必填
默认值
消息属性
string
下拉框选择输出消息绑定的属性,HTTP Request 只支持绑定 payload
payload
类型选择
string
下拉框选择输出消息 payload 绑定的数据类型,包括 message 内置数据类型和自定义数据类型
数据消费模式
string
下拉框选择是否对消息数据进行持久化处理:<br/>repeatable:默认处理方式,消息数据可在一次触发中持续重复使用<br/>non-repeatable:数据一次性消费,用于大文件数据的流式高效处理,暂时支持 JSON 数组类型,其超过5M时建议选择该模式
repeatable
安全网关名称
string
直接请求内网域名/IP 时,需要绑定安全网关

输出

HTTP Request 请求的响应返回后,会将响应结果生成对应的消息传递给下一个组件。其中,响应的基本信息、Header、Query 参数、Path 参数会放到消息的 attributes 中,响应的 body 会放到消息的 payload 中。
HTTP Request 输出消息描述
消息属性
payload
响应 body 保存在 payload 中,支持所有内置消息类型和自定义消息类型,其中 application/json、application/xml、application/yaml、application/x-www-form-urlencoded、multipart/form-data 等结构的 payload 支持在表达式中结构化访问
error
执行失败后,error 为 dict 类型,包含“Code”和“Description”字段:“Code”字段表示错误类型,“Description”字段表示错误具体信息
attributes
保存响应的属性值,具体包括:

statusCode:响应的状态码,例如:200

reasonPhrase:响应的文本描述,例如:OK

headers:响应的 header,结构为: dict<string,list
>cookies:响应的 cookie,结构为: dict<string,string>,解析 Cookies 逻辑比较常见,可通过该数据直接读取
variables
默认为空

案例

1. 组件筛选 HTTP Request。
image-20210426211753938


2. 新建并配置 HTTP Request 连接器,请求域名www.qq.com。(此案例参考方法一进行配置)

配置界面如下:



3. 使用操作配置。


4. 发布并触发。浏览器访问触发对应流,可以直接跳转至腾讯首页。


同时,应用测试模式下可以看到 HTTP Request 对应的 attributes。



方法三(2022年4月8日后创建的应用)

连接配置

HTTP Request 连接器连接配置中包括 Base URL、证书验证、最大重定向次数及安全网关名称。



上述连接器配置参数相关描述如下表所示:
参数
数据类型
描述
是否必填
默认值
Base URL
string
一般配置请求地址的公共部分
证书验证
string
开启后则请求HTTP服务时跳过证书验证
HTTPS
最大重定向数
int
重定向次数,最小值1,最大值10
1
请求超时时间
string
设置请求的超时时间,最大5分钟,最小1分钟
1
安全网关名称
string
直接请求内网域名/IP 时,需要绑定安全网关

配置说明

HTTP Request 操作配置包括基本配置、高级配置两项:



参数介绍

基本配置:HTTP Request 连接器基本配置中包括请求URL、请求方法、URL参数、请求头、请求体,其中请求URL、请求方法为必填项。
高级配置:HTTP Request 连接器高级配置中输出消息绑定自定义数据类型,可用于自定义输出消息数据类型。



基础配置参数描述
高级配置参数描述
参数
参数类型
描述
是否必填
默认值
请求 URL
string/表达式
如果在连接配置中配置了 BaseUrl,请配置相对 URL,否则配置完整的请求URL
/
请求方法
string
下拉单选指定发送请求的方法,全集为:GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS
GET
URL 参数
表达式
用于指定发送请求的 URL 参数,结构为:dict<string,string>
请求头
表达式
用于指定发送请求的请求头,结构为:dict<string,list>
请求体
string/表达式
用于设置发送请求的消息体

参数
参数类型
描述
是否必填
默认值
消息属性
string
下拉框选择输出消息绑定的属性,HTTP Request 只支持绑定 payload
payload
类型选择
string
下拉框选择输出消息 payload 绑定的数据类型,包括 message 内置数据类型和自定义数据类型
数据消费模式
string
下拉框选择是否对消息数据进行持久化处理:<br/>repeatable:默认处理方式,消息数据可在一次触发中持续重复使用<br/>non-repeatable:数据一次性消费,用于大文件数据的流式高效处理,暂时支持 JSON 数组类型,其超过5M时建议选择该模式
repeatable

输出

HTTP Request 请求的响应返回后,会将响应结果生成对应的消息传递给下一个组件。其中,响应的基本信息、Header、Query 参数、Path 参数会放到消息的 attributes 中,响应的 body 会放到消息的 payload 中。
HTTP Request 输出消息描述
消息属性
payload
响应 body 保存在 payload 中,支持所有内置消息类型和自定义消息类型,其中 application/json、application/xml、application/yaml、application/x-www-form-urlencoded、multipart/form-data 等结构的 payload 支持在表达式中结构化访问
error
执行失败后,error 为 dict 类型,包含“Code”和“Description”字段:“Code”字段表示错误类型,“Description”字段表示错误具体信息
attributes
保存响应的属性值,具体包括:

statusCode:响应的状态码,例如:200

reasonPhrase:响应的文本描述,例如:OK

headers:响应的 header,结构为: dict<string,list
>cookies:响应的 cookie,结构为: dict<string,string>,解析 Cookies 逻辑比较常见,可通过该数据直接读取
variables
默认为空

案例

1. 新增组件时,筛选 HTTP Request。
image-20210426211753938


2. 新建并配置 HTTP Request 连接器,BaseURL 配置为:https://cloud.tencent.com


配置界面如下:


3. 使用操作配置。



4. 发布并触发。浏览器访问触发对应流,可以直接跳转至腾讯云首页。

集成流如下:

同时,应用测试模式下可以看到 HTTP Request 对应的 payload、 attributes。
payload:


attributes: