python httpx如何使用
什么是 Httpx
Httpx 是一个 python 库,它提供了一个现代化的、易于使用的 HTTP 客户端和服务器。Httpx 可以与 Python 的异步框架协同工作,并支持 websocket 和 HTTP/2。Httpx 具有极佳的性能和安全性,并支持对各种不同的协议、编码和验证方案进行灵活配置。
安装 Httpx
安装 Httpx 库非常简单。只需使用 pip 包管理器运行以下命令即可:
pip install httpx
如果您正在使用 Python 3.7 或更早版本,则需要安装 Httpx 的异步依赖项 aiohttp。
您可以通过运行以下命令来安装它:
pip install httpx[aiohttp]
发送 HTTP 请求
使用 Httpx 发送 HTTP 请求非常简单。以下是一个简单的示例,它使用 Httpx 发送一个 GET 请求:
import httpx
response = httpx.get('https://www.baidu.com')
print(response.status_code)
print(response.text)
在这个示例中,我们使用 Httpx 的 get 方法发送了一个 GET 请求。该请求的 URL 是 https://www.baidu.com。该方法返回一个 Response 对象,我们可以使用该对象来访问响应状态码和响应文本。
Httpx 支持许多不同的 HTTP 方法,包括 GET、POST、PUT、DELETE、HEAD 和 OPTIONS。您可以使用 Httpx 的方法来发送这些请求。
以下是一些示例:
import httpx
response = httpx.post('https://www.baidu.com', data={'key': 'value'})
response = httpx.put('https://www.baidu.com', data={'key': 'value'})
response = httpx.delete('https://www.baidu.com')
response = httpx.head('https://www.baidu.com')
response = httpx.options('https://www.baidu.com')
上述示例中的每个请求都可以使用 Httpx 的方法来发送。这些方法中的大多数都支持传递数据、标头和查询参数等参数。
发送异步 HTTP 请求
Httpx 还支持异步 HTTP 请求。以下是一个简单的示例,它使用 Httpx 发送一个异步 GET 请求:
import httpx
import asyncio
async def get_request():
async with httpx.AsyncClient() as client:
response = await client.get('https://www.baidu.com')
print(response.status_code)
print(response.text)
asyncio.run(get_request())
在这个示例中,我们创建了一个名为 get_request 的异步函数,它使用 Httpx 的 AsyncClient 类来发送一个异步 GET 请求。在异步函数中,我们使用 async with 语句来创建 Httpx 的异步客户端。使用这种方式创建客户端可以确保在请求完成后自动关闭客户端。然后,我们使用 await 关键字来异步等待响应,并从响应对象中访问响应状态码和响应文本。
类似于同步请求,Httpx 的异步客户端也支持许多不同的 HTTP 方法。
以下是一些示例:
import httpx
import asyncio
async def post_request():
async with httpx.AsyncClient() as client:
response = await client.post('https://www.baidu.com', data={'key': 'value'})
print(response.status_code)
print(response.text)
asyncio.run(post_request())
设置请求标头
在发送 HTTP 请求时,您通常需要设置请求标头。Httpx 允许您通过在请求方法中传递 headers 参数来设置请求标头。
以下是一个示例:
import httpx
headers = {
'User-Agent': 'Mozilla/5.0 (windows NT 10.0; Win64; x64) AppleWEBKit/537.36 (Khtml, like Gecko) Chrome/58.0.3029.110 Safari/537.3'}
response = httpx.get('https://www.baidu.com', headers=headers)
print(response.status_code)
print(response.text)
在这个示例中,我们使用 headers 参数设置了一个名为 User-Agent 的请求标头。
设置请求参数
Httpx 允许您在发送 HTTP 请求时设置请求参数。
以下是一些示例:
import httpx
params = {'key1': 'value1', 'key2': 'value2'}
response = httpx.get('https://www.baidu.com', params=params)
print(response.status_code)
print(response.text)
在这个示例中,我们使用 params 参数设置了两个查询参数 key1 和 key2。
发送请求体
在发送 POST、PUT 和 DELETE 请求时,您通常需要在请求体中包含数据。Httpx 允许您使用 data 参数设置请求体中的数据。
以下是一个示例:
import httpx
data = {'key': 'value'}
response = httpx.post('https://www.baidu.com', data=data)
print(response.status_code)
print(response.text)
在这个示例中,我们使用 data 参数设置了一个名为 key 的请求体参数。
发送 JSON 数据
Httpx 允许您使用 json 参数发送 JSON 数据。
以下是一个示例:
import httpx
data = {'key': 'value'}
response = httpx.post('https://www.baidu.com', json=data)
print(response.status_code)
print(response.text)
在这个示例中,我们使用 json 参数设置了一个名为 key 的 JSON 请求体参数。
设置超时
在发送 HTTP 请求时,您通常需要设置超时时间。Httpx 允许您使用 timeout 参数设置超时时间。
以下是一个示例:
import httpx
response = httpx.get('https://www.baidu.com', timeout=5)
print(response.status_code)
print(response.text)
在这个示例中,我们使用 timeout 参数设置了 5 秒的超时时间。
错误处理
Httpx 可以抛出各种不同类型的异常,以帮助您诊断和解决问题。以下是一些常见的异常:
httpx.HTTPError:发生 HTTP 错误时引发。
httpx.RequestError:发生请求错误时引发。
httpx.networkError:发生网络错误时引发。
httpx.TimeoutException:发生超时时引发。
在处理这些异常时,您可以使用 try/except 语句来捕获异常并采取适当的措施。以下是一个示例:
import httpx
try:
response = httpx.get('https://www.baidu.com')
response.raise_for_status()
except httpx.HTTPError as http_error:
print(f'HTTP error occurred: {http_error}')
except httpx.RequestError as request_error:
print(f'Request error occurred: {request_error}')
except httpx.NetworkError as network_error:
print(f'Network error occurred: {network_error}')
except httpx.TimeoutException as timeout_error:
print(f'Timeout error occurred: {timeout_error}')
else:
print(response.status_code)
print(response.text)
在这个示例中,我们使用 try/except 语句捕获了所有可能发生的异常,并根据异常类型采取了适当的措施。
证书验证
Httpx 允许您验证 SSL 证书以确保与服务器的安全连接。默认情况下,Httpx 会验证 SSL 证书。如果您需要禁用证书验证,可以将 verify 参数设置为 False。
以下是一个示例:
import httpx
response = httpx.get('https://www.baidu.com', verify=False)
print(response.status_code)
print(response.text)
在这个示例中,我们将 verify 参数设置为 False,以禁用 SSL 证书验证。
使用代理
Httpx 允许您使用代理来发送 HTTP 请求。以下是一个示例:
import httpx
proxies = {
'http://http-proxy-server:8080',
'https://https-proxy-server:8080'
}
response = httpx.get('https://www.baidu.com', proxies=proxies)
print(response.status_code)
print(response.text)
在这个示例中,我们使用 proxies 参数设置了两个代理服务器。
上传文件
Httpx 允许您使用 files 参数上传文件。以下是一个示例:
import httpx
files = {'file': ('file.txt', open('file.txt', 'rb'))}
response = httpx.post('https://www.baidu.com', files=files)
print(response.status_code)
print(response.text)
在这个示例中,我们使用 files 参数上传了名为 file.txt 的文件。
使用 Cookie
Httpx 允许您使用 cookies 参数发送 cookie。以下是一个示例:
import httpx
cookies = {'name': 'value'}
response = httpx.get('https://www.baidu.com', cookies=cookies)
print(response.status_code)
print(response.text)
在这个示例中,我们使用 cookies 参数发送了名为 name 的 cookie。
以上就是python httpx如何使用的详细内容,更多请关注其它相关文章!
相关文章