HTTP请求

因软件更新较快,部分文档内容与软件最新版本有所出入,请知悉。


概述

发送Http请求,调用网络服务。

使用此模块需要您了解http协议的有关内容。



 参数

【网址】要调用的URL。

【方法】HTTP Method。支持:GET、POST等。

【请求头】Http Header。格式为多行文本,每行内容格式为 Name:Value。

请勿在请求头中增加Content-Type,而是将其放入【内容类型】参数中。

【Cookie】请求的Cookie内容。

注:如果希望将词典转换成cookie内容,可以在1.9.5+以上版本上使用表达式转换:$= String.Join(" ", {dict}.Select(x => x.Key+ "=" + x.Value +";"))

也可以使用动作复制网页cookie:复制当前网页Cookie - by CL - 动作信息 - Quicker

【请求体类型】Http方法为“Post”时,指示请求体内容类型。可选为:

  • JSON:请求体的内容为JSON数据。
  • 表单:发送表单数据。
  • Multipart表单:发送带文件的表单,类似于网页中的上传文件表单。
  • 单个文件或图片变量(二进制):发送文件或图片变量中的内容。
  • 纯文本:纯文本内容。

【请求体】实际要发送的内容。 根据请求体类型不同传入不同格式的内容,详见本文后续章节。

【内容类型】请求体的内容类型,对应于http请求的Content-Type请求头。本参数仅在请求体类型为JSON单个文件或图片变量纯文本时有效。(1.38.14之前版本仅对单个文件或图片变量类型有效。)

【结果类型】返回值的类型,可选“文本”“图片”“文件”。要和实际调用返回的类型匹配。

【UserAgent】模拟浏览器的UserAgent参数。

【超时时间】请求超时秒数。

【禁止重定向】是否禁止自动进行http redirect。

【显示进度条】是否显示上传下载进度条。

【忽略HTTPS证书验证】是否忽略证书异常情况。

【强制使用代理】忽略软件设置中的代理服务设置,而在本步骤中启用代理。将会优先使用软件中设置的代理服务器,如果未设置,则会使用系统默认代理设置。


输出

【是否成功】请求是否成功。

【状态码】http响应状态码。

【响应头】响应消息的Http Header。

【响应Cookie】响应内容的cookie信息。返回的是词典类型。

【文本结果】

  • 结果类型为“文本”时,响应内容结果。
  • 结果类型为“文件”时,输出生成的临时文件路径。(1.31.1+)

【图片结果】结果类型为“图片”时,将图片转换为变量。


Post数据格式说明

JSON

ContentType设置为application/json。此时请求体内容应该为一个合法的json数据文本。如:


{"title":"test","sub":[1,2,3]}


使用表达式得到json格式的请求体内容

$= JsonConvert.SerializeObject(
new
	{
		字段1={变量1},
        字段2={变量2}
	}
)

这段代码创建了一个临时c#对象,并使用 JsonConvert.SerializeObject 将临时对象序列化为json内容。

自1.29.0+ 版本以后,也可以直接将词典变量或匿名对象传递给请求体参数。Quicker会自动转换为json。

$= {词典变量} $=new {name="张三", age=20}

更多获取合法json的方式请参考此文档


文本表单

ContentType设置为x-www-form-urlencoded。类似于浏览器中的<form>表单。请求体数据格式类似于:


id=3&name=Hello&param1=value1


Multipart表单

ContentType设置为multipart/form-data。数据格式为:

  • 每行一个参数:参数名=参数值 或 参数名=FILE:文件路径的形式

类似于:

param1=value1
param2=value2
FileParam=FILE:文件完整路径
ImgFileParam=IMG:图片变量名


单个文件或图片变量(二进制)

如果需要上传文件,格式为:“FILE:完整文件路径”。注意冒号要小写。


FILE:C:\Users\Leal\Pictures\jiupian.PNG


如需上传图片变量,格式为:“IMG:变量名”,冒号要小写。


IMG:img



乱码问题

如果通过本模块获取某些网页后有乱码,可以尝试使用这个子程序:

https://getquicker.net/subprogram?id=c1cbb130-e2b3-4260-f84a-08d8e37a0602


示例



更新说明

  • 20230312 增加强制使用代理参数;
  • 20230602 1.38.14 对文本、JSON 请求体类型,支持通过【内容类型】参数设定Content-Type请求头的值。



反馈与讨论

语雀在语雀上查看