功能
HttpPost 请求。向指定请求地址提交请求数据并进行处理(例如提交表单或者上传文件)。数据被包含在请求体中,POST 请求可能会导致新的资源的建立或已有资源的修改。
输入
| 名称 | 说明 | 示例 |
|---|---|---|
| 请求地址[*] | 【字符串】要输入的网址。 | 'https://fanyi.youdao.com/' |
| 请求头 | 【字符串】要输入的请求头的名称和键值。 | 数据 |
| 请求数据 | 【字符串】要输入的请求数据的名称和键值,与 “Http数据” 参数二选一填写即可,若同时填写,则以 “Http数据” 为准 | 数据 |
| Http数据 | 【THttpData】Http 请求数据,与“请求数据”参数二选一填写即可,若同时填写,则以 “Http数据” 为准 | http 数据(创建变量) |
选项
| 名称 | 说明 | 示例 |
|---|---|---|
| 代理参数 | 【字符串】输入的格式为 地址:端口 | |
| 使用方法 | 【枚举】indy/com 默认是 indy,可选择 com 接口进行请求 | indy |
| 安全套接字协议 | 【枚举】空/SSLv2/SSLv23/SSLv3/TLSv1,根据需求选择,若勾选了'忽略安全认证',则该参数被忽略。 | SSLv23 |
| 编码 | 【枚举】UTF8/GBK,根据需求选择,默认为 UTF8 | UTF8 |
| 超时(毫秒) | 【整型】指定最长等待时间(以毫秒为单位),如果超出该时间活动未运行,就会报错。默认值为30000毫秒(30秒) | |
| 忽略安全认证 | 【布尔型】勾选此复选框,可忽略'安全套接字协议'参数,即不需要选择 ssl,默认情况下,未勾选此复选框 | 否 |
| 返回响应头信息 | 【布尔型】勾选此复选框,才能在输出项中返回响应头信息,默认情况下,未勾选此复选框。此参数在2023.03.13及之后版本的 Server 中新增加的。 | 否 |
输出
| 名称 | 说明 | 示例 |
|---|---|---|
| 结果 | 【字符串】返回该网址的超文本标记语言(html) | 输出(创建变量) |
| 导出文件 | 【字符串】将结果导出为文件,若将结果导出成文件,则忽略输出结果 | 'D:\桌面\内容.txt' |
| 响应头信息 | 【字符串】输出响应头信息,此参数在2023.03.13及之后版本的 Server 中新增加的。 | 输出响应头信息(创建变量) |
注意/说明
1.“请求地址“参数中包含不同协议时,对应“使用方法”参数选择如下:
(1)地址中包含 http 协议时,可使用 indy 使用方法或 com 使用方法,且“安全套接字协议”参数默认为空即可。
(2)地址中包含 https 协议时,可使用 indy 使用方法或 com 使用方法,若使用 indy 使用方法则需选择“安全套接字协议”参数值,如选择 SSLv2;若使用 com 使用方法则“安全套接字协议”参数默认为空即可。
注意:若勾选了“忽略安全认证”参数,则“安全套接字协议”参数无效,请根据实际选择对应的使用方法。
2.请求头、请求数据的输入格式如下图:
3.若“请求数据”和 “Http数据” 参数同时填写,只会提交 “Http数据” 参数里的数据,而“请求数据”参数里的数据不被提交。
4.若是需要返回响应头信息,则需勾选“返回响应头信息”参数;若是需要返回完整的响应头信息,则除了勾选“返回响应头信息”参数外,还需勾选“忽略安全认证”参数且保证响应码为200。
5.执行该函数之前,需要先安装 SSLLibrary 插件,如下图所示,详细安装过程可参考:《SSLLibrary安装》。
相关函数
【日志消息】
示例/演示
一、使用方法选择 com 请求,执行结果如下: 二、请求返回完整响应头时,执行结果如下: