### Python `requests` 库中 `post` 方法参数详解 #### 基本概念 `requests.post()` 是用于发起 HTTP POST 请求的方法。该方法允许向指定 URL 发送数据，通常用于提交表单或上传文件等操作。 以下是 `requests.post()` 的主要参数及其功能： --- #### 1. **url** 这是目标服务器的地址，即要发送 POST 请求的目标 URL。 ```python url = "https://example.com/api" ``` --- #### 2. **data** 当需要以表单的形式发送数据时，可以使用 `data` 参数。它接受一个字典类型的对象，其中键值对表示表单字段和对应的值。这些数据会被编码为 `application/x-www-form-urlencoded` 格式并附加到请求体中[^1]。 ```python import requests data = { 'username': 'test_user', 'password': 'test_password' } response = requests.post(url, data=data) print(response.status_code) # 输出状态码 ``` 上述代码会将数据作为表单数据发送，并且 Content-Type 默认被设置为 `application/x-www-form-urlencoded`[^4]。 --- #### 3. **json** 如果希望以 JSON 格式发送数据，则应使用 `json` 参数。此时，`requests` 会自动将字典转换为 JSON 字符串，并将请求头中的 `Content-Type` 设置为 `application/json`[^2]。 ```python import json payload = { 'key1': 'value1', 'key2': 'value2' } response = requests.post(url, json=payload) print(json.dumps(payload)) # 手动查看 JSON 数据结构 ``` 注意：`json` 和 `data` 不可同时使用，因为它们分别对应不同的 Content-Type。 --- #### 4. **headers** 可以通过 `headers` 参数自定义请求头信息。这在某些情况下非常有用，比如模拟浏览器行为、添加认证令牌或其他元数据[^3]。 ```python custom_headers = { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)', 'Authorization': 'Bearer your_token_here' } response = requests.post(url, headers=custom_headers, data={'field': 'value'}) ``` --- #### 5. **files** 对于文件上传场景，可以利用 `files` 参数来实现。此参数接收一个字典，其键代表文件名，而值是一个二进制流或者路径字符串。 ```python file_data = {'upload_file': open('example.txt', 'rb')} response = requests.post(url, files=file_data) ``` --- #### 6. **timeout** 为了防止网络延迟导致程序卡死，建议设置超时时间（单位为秒）。超过设定的时间未收到响应则抛出异常[^3]。 ```python try: response = requests.post(url, timeout=5) except requests.Timeout: print("Request timed out.") ``` --- #### 7. **auth** 支持基本身份验证（Basic Authentication），可以直接通过 `auth` 参数提供用户名和密码[^3]。 ```python from requests.auth import HTTPBasicAuth credentials = HTTPBasicAuth('user_name', 'pass_word') response = requests.post(url, auth=credentials) ``` --- #### 返回值处理 无论采用何种方式发送 POST 请求，返回的结果都存储于 `Response` 对象中。常见的属性包括： - `.status_code`: 获取 HTTP 状态码； - `.text`: 提取 HTML 或纯文本内容； - `.content`: 获取原始字节流； - `.json()`: 如果服务端返回的是合法 JSON 数据，则可通过调用此方法解析成 Python 字典。 示例代码如下所示： ```python if response.status_code == 200: result = response.json() else: error_message = f"Error occurred with status code {response.status_code}" raise Exception(error_message) ``` --- 问题