如何使用 Python 发送 HTTP 请求？

时间：2024-12-12 17:58:34

在Python中发送HTTP请求最常用的库是requests，它提供了简单易用的API来发送各种类型的HTTP请求。

除此之外，还有标准库中的http.client（以前叫做httplib）和urllib，但它们相对更底层，代码量较大，对于大多数应用来说不是最优选择。

使用 requests 库

首先确保安装了requests库。如果尚未安装，可以通过pip安装：

pip install requests

构造HTTP请求

使用requests库可以轻松地构造GET、POST等不同类型的HTTP请求。下面是构造GET请求的例子：

import requests

def get_request(url, params=None):
    """
    发送一个GET请求并返回响应内容。
    
    :param url: 请求的目标URL
    :param params: (可选) URL参数字典
    :return: 响应对象
    """
    try:
        response = requests.get(url, params=params)
        # 检查请求是否成功
        response.raise_for_status()
        return response
    except requests.exceptions.RequestException as e:
        print(f"An error occurred: {e}")
        return None

# 示例调用
response = get_request('https://api.example.com/data', {'key': 'value'})
if response is not None:
    print(response.text)  # 或者 response.json() 如果API返回JSON格式的数据

对于POST请求，我们可以像这样传递数据：

def post_request(url, data=None, json=None):
    """
    发送一个POST请求并返回响应内容。
    
    :param url: 请求的目标URL
    :param data: (可选) 要发送的表单数据字典
    :param json: (可选) 要发送的JSON数据字典
    :return: 响应对象
    """
    try:
        response = requests.post(url, data=data, json=json)
        response.raise_for_status()
        return response
    except requests.exceptions.RequestException as e:
        print(f"An error occurred: {e}")
        return None

# 示例调用
response = post_request('https://api.example.com/post', json={'key': 'value'})
if response is not None:
    print(response.text)

处理响应

当接收到响应后，通常需要检查状态码以确定请求是否成功，以及解析响应的内容。requests库提供了方便的方法来访问这些信息。

def process_response(response):
    """
    处理HTTP响应，打印状态码和内容。
    
    :param response: HTTP响应对象
    """
    if response is not None:
        print(f"Status Code: {response.status_code}")
        print("Headers:")
        for key, value in response.headers.items():
            print(f"{key}: {value}")
        
        # 根据响应内容类型决定如何处理
        content_type = response.headers.get('content-type')
        if 'application/json' in content_type:
            print("Response JSON:")
            print(response.json())
        else:
            print("Response Text:")
            print(response.text)

# 继续上面的例子
process_response(response)

错误处理

网络请求可能会失败，因此必须正确处理可能发生的异常。requests库抛出的异常主要包括ConnectionError、Timeout、TooManyRedirects和HTTPError等。我们可以在捕获这些异常时采取适当的措施，比如重试请求或通知用户。

try:
    response = requests.get('https://api.example.com/fail', timeout=5)
    response.raise_for_status()
except requests.exceptions.Timeout:
    print("The request timed out.")
except requests.exceptions.TooManyRedirects:
    print("Too many redirects.")
except requests.exceptions.HTTPError as http_err:
    print(f"HTTP error occurred: {http_err}")  # Python 3.6+
except Exception as err:
    print(f"Other error occurred: {err}")  # Python 3.6+
else:
    print("Success!")

实际开发中的注意事项

  1. 超时设置：始终为请求设置合理的超时时间，避免程序卡死。
  2. 重试机制：在网络不稳定的情况下考虑实现自动重试逻辑。
  3. 认证与安全：处理涉及敏感信息的请求时，务必使用HTTPS，并根据需要添加认证信息。
  4. 并发控制：如果你的应用需要频繁发送请求，考虑使用线程池或异步IO来优化性能。
  5. 清理资源：确保关闭不再使用的连接，尤其是在长时间运行的应用中。
  6. 遵守API限流规则：许多服务都有速率限制，应该遵循这些规定以免被封禁。

最佳实践

  • 使用上下文管理器（with语句）来确保文件和其他资源得到正确的清理。
  • 在生产环境中，记录日志而不是直接打印错误信息。
  • 对于大型项目，创建一个专门用于发出HTTP请求的模块或类，以便于维护和复用代码。
  • 遵循PEP 8编码风格指南，保持代码整洁和易于阅读。

通过以上几点，你可以在日常开发中更加专业地使用Python发送HTTP请求。希望这个回答对你有帮助！

相关文章