设置接口请求

请求URL与URL参数

在接口自动化用例的“脚本”页签中填写需要请求的URL、支持HTTP/HTTPS请求。

接口自动化可以支持以下类型URL请求方式。其中，新建的URL的请求方式默认为GET方式。

请求方式	说明
GET	从API检索数据。
POST	上传文件和添加新数据。
PUT	替换现有数据。
DELETE	删除现有数据。
HEAD	获取响应的HTTP头。
OPTIONS	预检请求。
PATCH	更新一些现有数据的字段。

在请求URL中支持使用环境参数、局部参数以及响应提取参数，使用方法请参考设置测试用例参数。

点击放大

请求头

接口自动化预置HTTP协议的常用请求头，在请求头模块，输入要填写的请求头信息。

请求头支持表单、文本两种格式。页面中默认使用表单形式，通过点击放大图标进行表单和文本的切换。

点击放大

表单：在请求头“名称”列选择或输入请求头名称，在“值”列选择/输入内容。
文本：需要按照“key:value”的格式填写请求头。
与表单模式不同的是，文本模式仅支持对“请求头名称”和“值”进行配置操作，但不支持对“描述”进行配置操作。

填写请求头时需要关注以下两点约束条件：
1. 请求头的总数不能超过30。
2. 请求头的长度不能超过10000。

测试计划服务中预置了多个常用的HTTP请求头，详情如下表：

请求头名称	说明
Accept	能接受的回应内容类型（Content-Types），如：text/plain等。
Accept-Charset	能接受的字符集，如：utf-8等。
Accept-Encoding	能接受的编码方式列表：compress \| gzip \| identity。
Accept-Language	能接受的回应内容的自然语言列表，如：en-US等。
Accept-Datetime	能接受的按照时间来表示的版本。
Access-Control-Request-Method	用于预检请求让服务器知道哪些HTTP方法的实际请求时将被使用。
Access-Control-Request-Headers	用于预检请求让服务器知道哪些HTTP头的实际请求时将被使用。
Authorization	用于超文本传输协议认证的认证信息。
Cache-Control	用来指定在请求/响应链中的所有缓存机制都必须遵守的指令。
Connection	浏览器优先使用的连接类型。
Cookie	由服务器通过Set- Cookie发送的一个超文本传输协议Cookie。
Content-Length	以八位字节数组（8位的字节）表示的请求体的长度。
Content-MD5	请求体内容的二进制MD5散列值，以Base64编码的结果。
Content-Type	请求体的多媒体类型（用于POST和PUT请求中），如：application/json。
Date	发送消息的日期和时间。
Expect	表明客户端要求服务器做出特定的行为。
Forwarded	包含来自被改变或丢失时代理参与请求的路径代理服务器的面向客户端的信息。用于调试，统计和生成依赖于位置的内容，并且通过设计它可以显示隐私敏感信息，例如客户端的IP地址。因此，在部署此标头时必须牢记用户的隐私。
From	发起请求的用户的邮件地址。
Host	服务器的域名（用于虚拟主机），以及服务器所监听的传输控制协议端口号。如果所请求的端口是对应的服务的标准端口，则端口号可省略。自超文件传输协议版本1.1（HTTP/1.1）开始是必需字段，在服务中如果URL中填写的域名为IP地址会自动添加该字段，否则请将被测应用的IP与端口信息填写在该字段。
If-Match	仅当客户端提供的实体与服务器上对应的实体相匹配时，才进行对应的操作。主要用作像PUT这样的方法中，仅在用户从上次更新某个资源以来，该资源未被修改的情况下，才更新该资源。
If-Modified-Since	允许在对应的内容未被修改的情况下返回304未修改（ 304 Not Modified ）。
If-None-Match	允许在对应的内容未被修改的情况下返回304未修改（ 304 Not Modified ），参考超文本传输协议的实体标记。典型用法中，URL被请求时，Web服务器会返回资源和其相应的ETag值，且会被放置在HTTP的ETag字段中，然后，客户端可以决定是否缓存该资源和相应的ETag。以后，如果客户端想再次请求相同的URL，将会发送一个包含已保存的ETag和If-None-Match字段的请求。
If-Range	如果实体未被修改过，则向发送方发送其所缺少的那一部分或多个部分，否则，发送整个新的实体。
If-Unmodified-Since	仅当实体自某个特定时间以来未被修改的情况下，才发送回应。
Max-Forwards	限制消息可被代理及网关转发的次数。
Origin	发起一个针对跨来源资源共享的请求。要求服务器在回应中加入一个“访问控制-允许来源”（Access-Control-Allow-Origin）字段。
Pragma	与具体的实现相关，这些字段可能在请求/回应链中的任何时候产生多种效果。
Proxy-Authorization	用来向代理进行认证的认证信息。
Range	仅请求某个实体的一部分，字节偏移从0开始。
Referer	表示浏览器访问的前一个页面上的某个链接将浏览器带到了当前所请求的这个页面。
TE	浏览器预期接受的传输编码方式：可使用回应协议头Transfer-Encoding字段中的值；还可用“trailers”（与“分块”传输方式相关）值来表明浏览器希望在最后一个尺寸为0的块之后还接收到一些额外的字段。
User-Agent	浏览器的浏览器身份标识字符串。
Upgrade	要求服务器升级到另一个协议。
Via	向服务器告知请求是由哪些代理发出的。
Warning	一个一般性的警告，告知在实体内容体中可能存在错误。