文档首页 > > 用户指南> 云测新版本> 测试设计> 设计接口测试用例> 接口请求

接口请求

分享
更新时间: 2020/07/06 GMT+08:00

请求URL与URL参数

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

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

请求头

接口测试预置了HTTP协议的常用请求头,在请求头模块,输入要填写的请求头信息。

云测服务中预置了40余个常用的HTTP请求头,详情如下表:

请求头名称

说明

Accept

能接受的回应内容类型(Content-Types),如:text/plain等。

Accept-Charset

能接受的字符集,如:utf-8等。

Accept-Datetime

能接受的按照时间来表示的版本。

Accept-Encoding

能接受的编码方式列表:compress | gzip | identity。

Accept-Language

能接受的回应内容的自然语言列表,如:en-US等。

Authorization

用于超文本传输协议认证的认证信息。

Cache-Control

用来指定在请求/响应链中的所有缓存机制都必须遵守的指令。

Connection

浏览器优先使用的连接类型。

Content-Length

以八位字节数组(8位的字节)表示的请求体的长度。

Content-MD5

请求体内容的二进制MD5散列值,以Base64编码的结果。

Content-Type

请求体的多媒体类型 (用于POST和PUT请求中),如:application/json。

Cookie

由服务器通过Set- Cookie发送的一个超文本传输协议Cookie。

Date

发送消息的日期和时间。

Expect

表明客户端要求服务器做出特定的行为。

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的块之后还接收到一些额外的字段。

Upgrade

要求服务器升级到另一个协议。

User-Agent

浏览器的浏览器身份标识字符串。

Via

向服务器告知请求是由哪些代理发出的。

Warning

一个一般性的警告,告知在实体内容体中可能存在错误。

X-Wap-Profile

链接到互联网上的一个XML文件,完整、仔细地描述了正在连接的设备。

X-Requested-With

主要用于标识Ajax及可扩展标记语言请求,大部分的JavaScript框架会发送这个字段,且将其值设置为XMLHttpRequest。

X-Http-Method-Override

请求某个网页应用程序使用该协议头字段中指定的方法(一般是PUT或DELETE)来覆盖掉在请求中所指定的方法(一般是POST)。当某个浏览器或防火墙阻止直接发送PUT或DELETE方法时(注意:这可能是因为软件中的某个漏洞需要修复,也可能是因为某个配置选项就是如此要求的,因而不应当设法绕过),可使用这种方式。

X-Forwarded-Proto

一个事实标准,用于标识某个超文本传输协议请求最初所使用的协议。

X-Forwarded-Host

一个事实标准,用于识别客户端原本发出的Host请求头部。

X-Forwarded-For

一个事实标准,用于标识某个通过超文本传输协议代理或负载均衡连接到某个网页服务器的客户端的原始互联网地址。

X-Csrf-Token

用于防止跨站请求伪造,辅助用的头部有X-CSRFToken或X-XSRF-TOKEN。

X-ATT-DeviceId

使服务器更容易解读AT&T设备User-Agent字段中常见的设备型号、固件信息。

Proxy-Connection

该字段源于早期超文本传输协议版本实现中的错误,与标准的连接(Connection)字段的功能完全相同。

Front-End-Https

被微软的服务器和负载均衡器所使用的非标准头部字段。

DNT

请求某个网页应用程序停止跟踪某个用户。在火狐浏览器中,相当于X-Do-Not-Track协议头字段(自Firefox/4.0 Beta 11版开始支持),Safari和Internet Explorer 9也支持这个字段。

请求体

请求体是接口请求需要传递的消息(报文),支持JSON、表单两种格式。

  • JSON格式下,JSON编辑器可以自动格式化显示JSON、校验JSON语法。

      

  • 表单格式下,支持文本和文件两种类型,文本类型设置参数名和值,文件类型设置参数名和文件。

      

高级配置

云测服务支持请求头对请求体进行编码校验,支持在输入框内直接进行编码操作。

当接口请求体设置完毕后,可以对请求体整体数据进行编码,并将编码后的数据添加到请求头中,以便后端对请求体进行校验,校验通过才能进行请求的相关操作。

  • 接口请求体的关键字为:APIConst_RequestBody。
  • 在请求头中的设置方式为:请求头名称选择“Warning”,值输入“$APIConst_RequestBody”

      

云测服务支持md5、base64、sha512三种编码方式对请求体进行编码,最多可进行两层编码。例如:

  • 一层编码:$base64{$APIConst_RequestBody}。
  • 两层编码:$sha512{$md5{$APIConst_RequestBody}}。
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问