首页/工具库/通信/HTTP客户端
通信

HTTP客户端

向指定 URL 发起 HTTP 请求并跟随重定向,支持 GET、POST 等标准方法、自定义请求头与超时设置,输出响应状态码、响应正文、响应头原文与执行状态
HttpClientTool · v1.0 · by system

输入参数 5

名称keyId类型默认值可连接说明
URLurlstringhttp://127.0.0.1:8080/否要访问的完整地址,需包含 http 或 https 协议头,默认指向本机 8080 端口;留空时返回 -1 并在运行信息提示 url 为空,请求过程会自动跟随服务端返回的重定向跳转
方法methodenumGET否请求使用的 HTTP 方法,默认 GET;界面提供 GET 与 POST 两档,程序按大写匹配并额外支持 HEAD、PUT、PATCH、DELETE、OPTIONS 等标准方法,POST 会把请求体作为载荷发送,无法识别的方法返回 -1 并提示不支持
请求体bodystring(空)否随请求发送的正文内容,默认留空;POST 时作为请求载荷提交,PUT 与 PATCH 等方法同样会携带该内容,GET 与 HEAD 请求不使用正文,留空时 POST 等方法会显式以零长度发送
请求头headersstring(空)否附加到请求的自定义头,按每行 Key: Value 书写,也支持在一行内用分号分隔多条;空行会被跳过,留空则不附加任何自定义头,解析出的条目逐条送入请求
超时(ms)timeoutMsint5000否单次请求允许耗费的最长毫秒数,默认 5000;取 0 或负数时按 5000 处理,超时或网络异常时返回 -1 并在运行信息给出具体失败原因

输出参数 5

名称keyId类型默认值可连接说明
运行结果resultCodeint—否0=请求完成并取回响应;-1=URL 为空、底层初始化失败、方法不受支持、请求失败或响应体超过 64MB 上限而中止,运行信息写明具体原因
运行信息resultInfostring—否本次请求的文字描述,成功时固定为 HTTP 加响应状态码,失败时改为具体原因,如 url 为空、curl 初始化失败、不支持的 HTTP 方法、请求失败或响应体超过 64MB 上限已中止
状态码status_codeint—否服务端返回的 HTTP 响应状态码,由底层在请求结束后读取,无论请求成功或失败都会写出;未完成请求或连接未建立时该值可能为 0,可配合运行状态判断是否真正收到响应
响应体bodystring—否服务端返回的响应正文,请求成功时为完整内容,因响应体超过 64MB 上限而中止传输时为已接收的部分内容;请求失败时同样会写出当前已收到的正文以便排查
响应头headersstring—否服务端返回的响应头原文,按接收顺序保留各行文本,成功时完整写出;请求失败时不产生该输出,响应头异常膨胀超过 1MB 时同样会中止传输

接入方式

在 FlowDesigner 中将「HTTP客户端」节点加入流程画布,把上游图像或数据连接至「URL」, 并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见 使用文档;安装与使用问题可通过 联系页 反馈。

← UDP服务端返回通信串口 →
联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题,可通过同一渠道反馈,无需注册或填写表单。

  • 安装包获取与部署说明
  • 界面组态与工具配置
  • 功能建议与问题反馈
微信扫码,获取安装包与反馈使用问题
微信扫码 · 安装包与问题反馈