在使用 requests 庫的 post 方法時，params 類型的參數通常用于在 URL 中作為查詢字符串傳遞。這與 data 或 json 參數不同，后者是放在請求體中的。下面詳細介紹如何在使用 post 方法時傳遞 params 參數。
使用 params 參數
params 參數接受一個字典或包含鍵值對的序列，這些鍵值對將被編碼并附加到請求的 URL 中作為查詢字符串。
示例代碼
import requests# 定義目標URL
url = 'https://httpbin.org/post'# 定義要傳遞的參數
params = {'key1': 'value1','key2': 'value2'
}# 發送POST請求，并傳遞params參數
response = requests.post(url, params=params)# 打印響應狀態碼
print('Status Code:', response.status_code)# 打印實際請求的URL（包含查詢參數）
print('Request URL:', response.request.url)# 打印響應內容（通常為JSON格式）
print('Response Body:', response.json())
輸出示例
Status Code: 200
Request URL: https://httpbin.org/post?key1=value1&key2=value2
Response Body: {'args': {'key1': 'value1', 'key2': 'value2'}, 'data': '', 'files': {}, 'form': {}, 'headers': {...}, 'json': None, 'method': 'POST', 'origin': '...', 'url': 'https://httpbin.org/post?key1=value1&key2=value2'}
在上面的示例中，params 參數被成功添加到了請求的 URL 中，作為查詢字符串 ?key1=value1&key2=value2。
params 與 data 和 json 的區別
? params: 用于將數據作為查詢字符串附加到 URL 中。適用于 GET 請求，但也可以與 POST 請求一起使用，將數據放在 URL 中。
? data: 用于將數據放在請求體中，通常用于發送表單數據。適用于 POST、PUT 等請求方法。
? json: 用于將數據以 JSON 格式放在請求體中。適用于需要發送 JSON 數據的 API 接口。
示例對比
使用 params
response = requests.post(url, params=params)
# 請求URL: https://httpbin.org/post?key1=value1&key2=value2
# 請求體: 空
使用 data
data = {'key1': 'value1','key2': 'value2'
}
response = requests.post(url, data=data)
# 請求URL: https://httpbin.org/post
# 請求體: key1=value1&key2=value2 （表單編碼）
使用 json
json_data = {'key1': 'value1','key2': 'value2'
}
response = requests.post(url, json=json_data)
# 請求URL: https://httpbin.org/post
# 請求體: {"key1": "value1", "key2": "value2"} （JSON格式）
注意事項
-
URL 長度限制: 雖然可以使用
params將數據附加到 URL 中，但需要注意瀏覽器和服務器對 URL 長度的限制。對于大量數據，建議使用data或json方法。 -
編碼問題:
requests庫會自動處理 URL 編碼，因此無需手動編碼參數。 -
安全性: 敏感信息不建議通過 URL 的查詢字符串傳遞，因為這些信息可能會被記錄在服務器日志或瀏覽器歷史中。
高級用法
傳遞列表或元組作為參數值
有時候，一個參數可能需要傳遞多個值。可以通過傳遞列表或元組來實現。
params = {'key1': 'value1','key2': ['value2', 'value3']
}response = requests.post(url, params=params)
print(response.request.url)
# 輸出: https://httpbin.org/post?key1=value1&key2=value2&key2=value3
使用 params 與其他參數結合
你也可以同時使用 params、data 和 headers 等其他參數。
params = {'search': 'robotframework'}
data = {'username': 'user', 'password': 'pass'}
headers = {'Authorization': 'Bearer YOUR_TOKEN'}response = requests.post(url, params=params, data=data, headers=headers)print(response.request.url) # 包含查詢參數
print(response.request.body) # 包含表單數據
print(response.request.headers) # 包含請求頭
完整示例
下面是一個更完整的示例，展示如何在實際應用中使用 params 參數發送 POST 請求，并處理響應。
import requestsdef post_with_params():url = 'https://httpbin.org/post'params = {'api_key': 'YOUR_API_KEY','token': 'SESSION_TOKEN'}data = {'username': 'testuser','action': 'login'}try:response = requests.post(url, params=params, data=data, timeout=10)response.raise_for_status() # 檢查請求是否成功result = response.json()print('請求成功！')print('API響應:', result)except requests.exceptions.HTTPError as http_err:print(f'HTTP錯誤發生: {http_err}')except Exception as err:print(f'其他錯誤發生: {err}')if __name__ == '__main__':post_with_params()
在這個示例中：
? 使用 params 傳遞了 api_key 和 token 作為查詢參數。
? 使用 data 傳遞了登錄所需的用戶名和動作。
? 添加了異常處理，以確保在請求失敗時能夠捕獲并報告錯誤。
總結
? params 參數用于將數據作為查詢字符串附加到請求的 URL 中。
? 雖然主要用于 GET 請求，但也可以與 POST 請求一起使用。
? 對于大量數據或敏感信息，建議使用 data 或 json 方法。
? requests 庫會自動處理參數的編碼，簡化了請求的構建過程。
希望這些信息能幫助你更好地理解和使用 requests 庫中的 params 參數！
)
