如何确定Python Pytest接口自动化测试中的请求参数格式？

本文共计2480个文字，预计阅读时间需要10分钟。

在进行接口测试前，首先需要依据接口文档或数据包内容，详细了解接口的详细内容，包括请求参数的编码格式。然后，按照相应的参数格式发送请求。例如，某个接口规定的请求参数格式为：

我们在做接口测试之前，先需要根据接口文档或抓包接口数据，搞清楚被测接口的详细内容，其中就包含请求参数的编码格式，从而使用对应的参数格式发送请求。例如某个接口规定的请求主体的编码方式为 application/json，那么在请求该接口时，请求参数格式必须是 json 格式，使用其他的编码方式请求不会成功。

那么，在www.baidu.com/s?ie=utf-8&wd=给你一页白纸-自由互联。

python代码发送请求

如果使用python中的 requests.get() 对上图示例发送get请求，则需使用参数 params，参数值为dict(字典)格式即可，示例如下：

import requests url = "www.baidu.com/s" params = {"wd": "给你一页白纸-自由互联", "ie": "utf-8"} res = requests.get(url=url, params=params) print(res.text)

GET请求中请求主体编码格式固定，在做接口测试时基本无需确定其编码格式，较为简单。

post请求参数格式

对于HTTP协议中的POST请求，其请求参数有不同的编码格式。

服务端通常是根据请求头(headers)中的 Content-Type 字段来获知请求中的消息主体是用何种方式编码 (即媒体类型)，再对请求参数进行对应方式的解析。

post请求常见的编码方式有四种：

1. application/x-www-form-urlencoded

2. multipart/form-data

3. application/json

4. text/xml

application/x-www-form-urlencoded

application/x-www-form-urlencoded 是最常见的 POST 提交数据的方式，用于表单数据的提交。浏览器的原生form表单，如果不设置enctype属性，那么最终就会默认以 application/x-www-form-urlencoded 方式提交数据。

说明

POST请求使用 application/x-www-form-urlencoded 对请求参数进行编码时，有以下特点：

1. 请求头header中content-type的值为：application/x-www-form-urlencoded

2. 请求参数会按照 key1=value1&key2=value2 的方式进行编码，且 key 和 value 都进行了 URL 转码

3. 服务器收到请求后，会对应的方式对这种编码格式的请求参数进行解析

4. 虽然都将请求参数进行了 key1=value1&key2=value2 形式编码，但GET请求中会将编码后的内容拼接在URL后。

以请求TesterHome网登陆接口为例：

Request Headers中的 content-type 为 application/x-www-form-urlencoded; charset=UTF-8。

python代码发送请求

使用python中的 requests.post() 请求上面图片中的接口时，需使用参数data，参数值为dict(字典)格式即可，代码如下：

import requests ''' 请求头的content-type为application/x-www-form-urlencoded ''' data = { "user[login]": "账号", "user[password]": "密码", "user[remember_me]": 0, "commit": "登录" } headers = { "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.82 Safari/537.36", "content-type": "application/x-www-form-urlencoded; charset=UTF-8" } url = "testerhome.com/account/sign_in" # 编码格式为application/x-www-form-urlencoded;charset=UTF-8，使用data参数，参数值为dict， res = requests.post(url=url, headers=headers, data=data) print(res.text) multipart/form-data

multipart/form-data 也是一个常见的 POST 数据提交的方式，用于上传文件。我们使用表单上传文件时，必须让 form 表单的enctype等于 multipart/form-data。

说明

POST 请求使用 multipart/form-data 对请求参数进行编码时，有以下特点：

1. 使用 boundary 用于分割不同的字段

2. 消息主体中按照字段个数又分为多个结构类似的部分，每部分都以--boundary开始，紧接着下一行是内容描述信息，再下一行是字段具体内容（文本或二进制）。如果传输的是文件，还要包含文件名和文件类型信息

3. 消息主体最后以 --boundary-- 标示结束

示例如下：

POST www.example.com HTTP/1.1 Content-Type:multipart/form-data; boundary=----WebKitFormBoundary8G1vtgT1pXWqqHzV ------WebKitFormBoundary8G1vtgT1pXWqqHzV Content-Disposition: form-data; name="txt" title ------WebKitFormBoundary8G1vtgT1pXWqqHzV Content-Disposition: form-data; name="file"; filename="blog.png" Content-Type: image/png PNG ... content of blog.png ... ------WebKitFormBoundary8G1vtgT1pXWqqHzV--

python代码发送请求

例如，我们在请求牛图网的上传图片的接口时，Requests Headers 中为content-type: multipart/form-data; boundary=----WebKitFormBoundary4aA3ZrkOVwUIvmx0，如下图所示：

在python中使用requests.post()请求该接口，代码示例如下：

import requests ''' 请求头的content-type为multipart/form-data ''' def post_mulitpart_form_data(): headers = { "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.82 Safari/537.36", "content-type": "multipart/form-data; boundary=----WebKitFormBoundary4aA3ZrkOVwUIvmx0" } url = "www.niupic.com/api/upload" filepath = "./dianzan.jpg" # 读取上传文件的内容 files = {"file": open(filepath, "rb")} # 使用files参数接收请求内容，即读取的上传文件内容 res = requests.post(url=url, headers=headers, files=files).content print(json.loads(res)) if __name__ == '__main__': post_mulitpart_form_data()

运行结果如下：

C:\Users\xiaoqq\AppData\Local\Programs\Python\Python37\python.exe E:/blog/python接口自动化/flask_demo/test.py {'status': 'success', 'code': 200, 'data': 'i.niupic.com/images/2022/02/20/9V3n.jpg', 'msg': '上传成功!'} Process finished with exit code 0

application/x-www-form-urlencoded 与 multipart/form-data 这两种 POST 请求的数据编码方式，都是浏览器原生支持的，且现阶段标准中原生form表单也只支持这两种方式（通过form元素的enctype属性指定，默认为 application/x-www-form-urlencoded。其实enctype还支持text/plain，不过用得非常少）。

application/json

在一般公司的普通业务场景中，application/json 很常见，用来告诉服务端，消息主体是序列化后的json字符串，即前端传给服务端的数据是json格式的。

也就是说，如果请求头中 content-type 为 application/json，那么我们在使用工具如postman或python脚本模拟请求接口时，请求参数也需要先转换成json格式，然后才能发送请求。代码示例如下：

import requests import json ''' 请求头的content-type为application/json ''' headers = {"Content-Type": "application/json;charset=utf8"} url = "127.0.0.1:5000/login" _data = { "username": "lilei", "password": "123456" } # 这里使用json参数，即json=_data res = requests.post(url=url, headers=headers, json=_data).text # 当然还可以使用data参数，但需先将_data转换为json格式，即data=json.dumps(_data) # json.dumps()将dict格式转换成json格式 res = requests.post(url=url, headers=headers, data=json.dumps(_data)).text print(res) text/xml

post请求中，有些请求主体的编码格式为 text/xml，即请求头中content-type 字段对应值为 text/xml，对于这样的接口，我们需要使用xml格式的参数去发送请求。

使用 requests.post() 发送请求参数为xml格式的post请求时，只需要将xml文件中的body部分写成一个字符串类型就行，遇到换行时在后面加个反斜杠，并将这个字符串赋值给data参数。代码示例如下：

import requests ''' 请求头的content-type为text/xml ''' def post_text_xml(): headers = {"Content-Type": "text/xml"} url = "httpbin.org/post" } Process finished with exit code 0 总结

这里只介绍了HTTP协议中 GET请求 和 POST请求 常见的请求参数编码格式，怎样确定请求参数的编码格式，以及在python代码中使用requests发送请求时，需要使用怎样格式的参数。

我们总结如下：

1. GET请求，请求参数编码格式为query string params，requests.get() 发送请求时使用params参数，params的值 (即请求参数) 为字典格式

2. POST请求主体的编码格式需要根据请求头中的content-type字段确定

3. content-type: application/x-www-form-urlencoded，requests.post() 发送请求时使用data参数，data的值 (即请求参数) 为字典格式

4. content-type: multipart/form-data，requests.post() 发送请求时使用files参数，files的值 (即请求参数) 即为读取的上传文件的内容

5. content-type: application/json，requests.post() 发送请求时使用json参数，json的值 (即请求参数) 为字典格式，或者也可以使用 data 参数，但此时需要先将请求参数转换为json格式

6. content-type: text/xml，requests.post() 发送请求时使用data参数，data的值 (即请求参数) 为 xml 中的body部分内容

具体的脚本编写方法参考示例代码。

左边二维码 为博主 个人微信 ， 扫码添加微信后可加入测试学习交流群 （添加时请务必备注：加入测试学习交流群）。 右边二维码 为博主 微信公众号 ，专注于自动化测试、测试开发技术分享，欢迎关注。 书山有路勤为径，学海无涯苦做舟。希望通过分享学习交流，大家能够朝着 最朴实的愿望--成长、加薪、升职 更进一步。 本文作者：给你一页白纸 版权申明：本博客所有文章除特殊声明外，均采用BY-NC-SA 许可协议。转载请注明出处！ 声援博主：如果觉得这篇文章对您有帮助，请点一下右下角的 “推荐” 图标哦，您的 “推荐” 是我写作的最大动力。您也可以点击下方的 按钮，关注博主不迷路。