功能块 HTTP_REQUEST

功能块 HTTP_REQUEST 为 HTTP 接口创建 RAW 查询。

重要说明:HTTP 接口要发送的变量必须具有 RAW 数据类型。

URI 作为右侧通信中的变量定义。如果它以 / 开头,则会删除第一个 /。如果要对最低目录发出请求,只能定义变量 /

某些 Web 服务器需要 User-Agent 标头。否则不会加载页面。这不是 Antcas Control 的错误,而是所请求的网页浏览器的保护机制。使用包含以下内容的 Header 输入:

User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.13) Gecko/20080311 Firefox/2.0.0.13

输入 Method

该输入定义传输的方法为字符串。它可以是例如 "GET""POST""PUT" 等。如果未定义方法,则会选择 GET 作为默认值。

输入 Type

该输入定义标头 Content-Type 为字符串。如果未定义该输入,则不会将该项添加到标头中。

输入 Header

定义额外的标头项为字符串。多个标头以换行符分隔。标头 Content-Length 会自动定义,并且标头 Content-Type 会使用输入 Type 的值定义。

输入 Query

该输入定义查询为字符串。查询是问号后面的值,通常用于 GET 请求中。

http://server/uri?query

查询的结构如下:

var1=wert1&var2=wert2&va...

为了能够正确传输值,建议使用功能块 URL_ENCODEQUERY_ENCODE 对各个值进行编码,因为数据可能无法完整传输。

提示:如果需要传输较大的数据量,请注意 URL 的最大长度。如果适用,请使用 POST 方法并将查询作为内容发送。

输入 Content

Content 输入与 Query 输入类似。但是,数据会在标头之后传输,并且支持较大的数据量。根据应用程序,Content 类型可能不具有查询方法。

提示:仅支持 UTF-8 兼容数据。建议使用功能块 BASE64_ENCODE 对二进制数据进行编码以传输它们。

输入 Timeout

该输入定义请求的超时时间为格式为 T#30s 的秒数。建议使用较高的超时值。小值可能导致请求无法完全执行。由于 Keep-Alive 过程,可能需要一段时间才能恢复正常处理请求。

输入 DIS

如果该输入为真,则输出 Request 的值将等于 NULL

输入 SET

如果该输入为真,则它会强制生成输出 Request。此输入优先于输入 DIS。

输出 Request

该输出返回格式为 JSON 的字符串。如果已禁用,则会返回值 NULL。通常将其直接与接口的输出变量连接。

输出 Length

该输出以字节为单位返回输入 Content 的长度。

输出 ID

返回最后生成的查询的 ID。这对于使用功能块 HTTP_RESPONSE 验证响应很有用。