requests库post方法如何传params类型的参数(最新推荐)_ar

在使用 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 requests
def 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 传递了登录所需的用户名和动作。
• 添加了异常处理，以确保在请求失败时能够捕获并报告错误。