python如何去调用一个接口

Python调用接口的方式有多种：使用requests库、使用http.client模块、使用urllib库。其中，使用requests库是最常见、最方便的方法。requests库具备易用性、支持多种HTTP方法、支持认证等特点。接下来，我们将详细介绍如何使用requests库调用接口。

一、安装requests库

在开始之前，你需要确保已安装requests库。如果没有安装，可以通过以下命令进行安装：

pip install requests

二、GET请求

GET请求是最常见的HTTP请求方法之一，通常用于请求获取某个资源。以下是使用requests库发送GET请求的示例：

import requests
url = 'https://api.example.com/data'
params = {'key1': 'value1', 'key2': 'value2'}
response = requests.get(url, params=params)
检查响应状态码
if response.status_code == 200:
    # 解析响应内容
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们首先定义了请求的URL和参数，然后使用requests.get方法发送GET请求。成功发送请求后，我们检查响应的状态码并解析响应内容。

三、POST请求

POST请求通常用于向服务器提交数据。以下是使用requests库发送POST请求的示例：

import requests
url = 'https://api.example.com/data'
data = {'key1': 'value1', 'key2': 'value2'}
response = requests.post(url, json=data)
检查响应状态码
if response.status_code == 200:
    # 解析响应内容
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们定义了请求的URL和数据，然后使用requests.post方法发送POST请求。与GET请求类似，我们检查响应的状态码并解析响应内容。

四、PUT请求

PUT请求用于更新资源。以下是使用requests库发送PUT请求的示例：

import requests
url = 'https://api.example.com/data/1'
data = {'key1': 'new_value1', 'key2': 'new_value2'}
response = requests.put(url, json=data)
检查响应状态码
if response.status_code == 200:
    # 解析响应内容
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们定义了请求的URL和数据，然后使用requests.put方法发送PUT请求。成功发送请求后，我们检查响应的状态码并解析响应内容。

五、DELETE请求

DELETE请求用于删除资源。以下是使用requests库发送DELETE请求的示例：

import requests
url = 'https://api.example.com/data/1'
response = requests.delete(url)
检查响应状态码
if response.status_code == 200:
    print("资源删除成功")
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们定义了请求的URL，然后使用requests.delete方法发送DELETE请求。成功发送请求后，我们检查响应的状态码。

六、处理响应

requests库提供了多种处理响应的方法。以下是一些常见的方法：

response.status_code：获取响应的状态码。
response.text：获取响应的文本内容。
response.json()：将响应内容解析为JSON对象。
response.headers：获取响应的头信息。

七、添加请求头

有时我们需要在请求中添加头信息，比如认证信息或自定义头。以下是添加请求头的示例：

import requests
url = 'https://api.example.com/data'
headers = {'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
response = requests.get(url, headers=headers)
检查响应状态码
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们定义了请求的URL和头信息，然后使用requests.get方法发送GET请求。

八、处理超时

在发送HTTP请求时，有时会遇到超时问题。我们可以使用timeout参数来设置请求的超时时间。以下是处理超时的示例：

import requests
url = 'https://api.example.com/data'
try:
    response = requests.get(url, timeout=5)
    if response.status_code == 200:
        data = response.json()
        print(data)
    else:
        print(f"请求失败，状态码：{response.status_code}")
except requests.Timeout:
    print("请求超时")
except requests.RequestException as e:
    print(f"请求失败：{e}")

在这个示例中，我们使用timeout参数设置请求的超时时间为5秒，并使用try-except结构来捕获和处理超时异常。

九、使用会话

requests库提供了会话对象，可以在多个请求之间保持某些参数。以下是使用会话对象的示例：

import requests
创建会话对象
session = requests.Session()
session.headers.update({'Authorization': 'Bearer YOUR_ACCESS_TOKEN'})
发送GET请求
url = 'https://api.example.com/data'
response = session.get(url)
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")
发送POST请求
url = 'https://api.example.com/data'
data = {'key1': 'value1', 'key2': 'value2'}
response = session.post(url, json=data)
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们创建了一个会话对象并更新了会话的头信息，然后使用该会话对象发送多个请求。

十、处理重定向

有时服务器会返回重定向响应。requests库默认会自动处理重定向，但我们也可以自定义处理重定向的行为。以下是处理重定向的示例：

import requests
url = 'https://api.example.com/redirect'
禁用自动重定向
response = requests.get(url, allow_redirects=False)
if response.status_code == 302:
    print(f"重定向到：{response.headers['Location']}")
else:
    print(f"请求失败，状态码：{response.status_code}")
自定义重定向行为
response = requests.get(url, allow_redirects=True)
if response.history:
    print(f"请求被重定向到：{response.url}")
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们首先禁用了自动重定向，然后检查响应的状态码和头信息。接下来，我们启用了自动重定向并检查请求的重定向历史记录。

十一、上传文件

requests库还支持文件上传。以下是上传文件的示例：

import requests
url = 'https://api.example.com/upload'
files = {'file': open('example.txt', 'rb')}
response = requests.post(url, files=files)
if response.status_code == 200:
    print("文件上传成功")
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们定义了请求的URL和文件，然后使用requests.post方法发送POST请求上传文件。

十二、处理Cookies

requests库可以自动处理Cookies。以下是处理Cookies的示例：

import requests
创建会话对象
session = requests.Session()
发送GET请求
url = 'https://api.example.com/login'
response = session.get(url)
if response.status_code == 200:
    print("请求成功")
else:
    print(f"请求失败，状态码：{response.status_code}")
查看Cookies
print(session.cookies)
发送另一个请求，Cookies将自动发送
url = 'https://api.example.com/data'
response = session.get(url)
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们创建了一个会话对象并发送了一个GET请求，然后查看会话中的Cookies。接下来，我们发送了另一个请求，Cookies将自动包含在请求中。

十三、处理认证

requests库支持多种认证方式，包括Basic认证和Bearer Token认证。以下是处理认证的示例：

import requests
from requests.auth import HTTPBasicAuth
Basic认证
url = 'https://api.example.com/data'
auth = HTTPBasicAuth('username', 'password')
response = requests.get(url, auth=auth)
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")
Bearer Token认证
url = 'https://api.example.com/data'
headers = {'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
response = requests.get(url, headers=headers)
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们使用了Basic认证和Bearer Token认证来发送GET请求。

十四、处理代理

requests库支持代理设置。以下是使用代理的示例：

import requests
url = 'https://api.example.com/data'
proxies = {
    'http': 'http://10.10.1.10:3128',
    'https': 'https://10.10.1.10:1080',
}
response = requests.get(url, proxies=proxies)
if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"请求失败，状态码：{response.status_code}")

在这个示例中，我们定义了请求的URL和代理，然后使用requests.get方法发送GET请求。

十五、总结

在这篇文章中，我们详细介绍了如何使用Python的requests库调用接口，包括发送GET、POST、PUT、DELETE请求，处理响应，添加请求头，处理超时，使用会话，处理重定向，上传文件，处理Cookies，处理认证和使用代理。requests库是一个功能强大且易于使用的HTTP库，适用于各种HTTP请求场景。通过掌握requests库的使用方法，你可以轻松地调用各种接口，完成数据获取、提交、更新和删除等操作。