Python 接口測試requests.post方法中data與json參數區別

　　引言

　　在隨筆分類Jmeter入門基礎中，分享過一篇《Jmeter處理http請求Content-Type類型和傳參方式》，這篇文章主要講述Jmeter做接口測試時，針對POST請求參數的傳遞方式。而在使用requests做接口測試的時候，與之不太一樣。requests.post主要參數是data與json，這兩者使用是有區別的，下面我詳情的介紹一下使用方法。

　　Requests參數

1. 先可以看一下requests的源碼：

def post(url, data=None, json=None, **kwargs):
    r"""Sends a POST request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, list of tuples, bytes, or file-like
        object to send in the body of the :class:`Request`.
    :param json: (optional) json data to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    """

    return request('post', url, data=data, json=json, **kwargs)

 

說明：

　　從源碼中注釋看，告訴我們post請求報文中既可以傳data，也可以傳json。並且data與json，既可以是str類型，也可以是dict類型。

 

2. json與data參數規則：

一、JSON

1.使用json參數，不管報文是str類型，還是dict類型，如果不指定headers中content-type的類型，默認是：application/json。

二、DATA

1.使用data參數，報文是dict類型，如果不指定headers中content-type的類型，默認application/x-www-form-urlencoded，相當於普通form表單提交的形式，會將表單內的數據轉換成鍵值對，此時數據可以從request.POST里面獲取，而request.body的內容則為a=1&b=2的這種鍵值對形式。

注意：即使指定content-type=application/json，request.body的值也是類似於a=1&b=2，所以並不能用json.loads(request.body.decode())得到想要的值。

2. 使用data參數，報文是str類型，如果不指定headers中content-type的類型，默認application/json。

 

綜上所述，兩種參數的使用情況：

用data參數提交數據時，request.body的內容則為a=1&b=2的這種形式，用json參數提交數據時，request.body的內容則為'{"a": 1, "b": 2}'的這種形式

 

　　實例解析

　　知道了上面所講的理論，需要通過實例來驗證一下。

以我django項目開發的web接口為例：

url.py文件

from django.contrib import admin
from django.urls import path,include
from django_web.views import views
from django.conf.urls import url

urlpatterns = [
    path('admin/', admin.site.urls),

    #首頁
    path('index/',views.test_dj), #登陸頁面

view.py文件

def test_dj(request):
    print(request.body,111)
    print(request.headers)
　　
"""
    當post請求的請求體以data為參數，發送過來的數據格式為：b'username=test&password=123'
    當post請求的請求體以json為參數，發送過來的數據格式為：b'{"username": "test", "password": "123"}'
"""
return render(request, 'index.html')

　　

exp1:

test.py

import requests

headers = {'content-type':'application/json'}

data = {
    "username": "test",

    "password": "123"
}

print(type(data)) #dict
r1 = requests.post(url="http://127.0.0.1:8000/index/",data=data)


print(r1.text)

 

返回的報文：

b'username=test&password=123' 111
{'Content-Length': '26', 'Content-Type': 'application/x-www-form-urlencoded', 'Host': '127.0.0.1:8000', 'User-Agent': 'python-requests/2.22.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive'}

 

exp1案例：證實了第二條規則：使用data參數，報文是dict類型，不指定content-type，默認是：application/x-www-form-urlencoded，請求數據格式是：key1=value1&key2=value2鍵值對形式。

 

exp2:

test.py

import requests

headers = {'content-type':'application/json'}

data = {
    "username": "test",

    "password": "123"
}

print(type(data)) #dict
r1 = requests.post(url="http://127.0.0.1:8000/index/",json=data)


print(r1.text)

 

將參數data換成json請求，返回的報文：

b'{"username": "test", "password": "123"}' 111
{'Content-Length': '39', 'Content-Type': 'application/json', 'Host': '127.0.0.1:8000', 'User-Agent': 'python-requests/2.22.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive'}

exp2案例：證實了第一條規則：使用json參數，報文是dict類型，如果不指定headers中content-type的類型，默認是：application/json，請求數據格式是：dict形式。

 

exp3:

test.py

import requests,json

headers = {'content-type':'application/json'}

data = {
    "username": "test",

    "password": "123"
}

print(type(data)) #dict

# 方法1
r1 = requests.post(url="http://127.0.0.1:8000/index/",data=json.dumps(data))
# 方法2
r2 = requests.post(url="http://127.0.0.1:8000/index/",json=json.dumps(data))


print(r1.text)
print(r2.request)

 

查看返回報文：

b'{"username": "test", "password": "123"}' 111
{'Content-Length': '39', 'Content-Type': 'text/plain', 'Host': '127.0.0.1:8000', 'User-Agent': 'python-requests/2.22.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive'}
b'"{\\"username\\": \\"test\\", \\"password\\": \\"123\\"}"' 111
{'Content-Length': '49', 'Content-Type': 'application/json', 'Host': '127.0.0.1:8000', 'User-Agent': 'python-requests/2.22.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive'}
[01/Mar/2020 14:02:11] "POST /index/ HTTP/1.1" 200 1890

　　

exp3案例：

證實了第一條規則：使用json參數，報文是str類型，如果不指定headers中content-type的類型，默認是：application/json，請求數據格式是：dict形式。也就是test.py中的方法2.

還證實了第三條規則：使用data參數，報文是str類型，如果不指定headers中content-type的類型，默認application/json。其實方法1和方法2是等價的。報文是json字符串數據，分別以data與json兩種參數形式發送請求，得到的請求體數據格式是一樣。

 

注意：方法1返回的數據類型是：'Content-Type': 'text/plain'，表示無格式，但規則說是默認application/json，是否有沖突？ 其實不然，服務器並沒有強制指定接收數據的格式類型，所以這種情況下也不會報錯。

 

 

 

　　總結

　　總而言之，記住這句話：用data參數提交數據時，request.body的內容則為a=1&b=2的這種形式，用json參數提交數據時，request.body的內容則為'{"a": 1, "b": 2}'的這種形式。

 

 

 

如果覺得此文對您有幫助，請給個贊以示鼓勵，謝謝。