Requests для начинающих + пара фишек для адептовrequests является де-факто стандартом для HTTP-запросов в Python. Она упрощает взаимодействие с веб-сервисами, предоставляя интуитивно понятный интерфейс для отправки запросов и обработки ответов.
Инструмент не входит в стандартную библиотеку ЯП, поэтому его необходимо установить отдельно:
python -m pip install requests
Рекомендуется устанавливать внешние пакеты в виртуальное окружение, чтобы избежать конфликтов зависимостей.
Основные методыДля
получения данных с сервера используется метод
GET:
import requests
response = requests.get('https://example.com')
print(response.text)
Для
отправки данных на сервер используется метод
POST:
import requests
data = {'key': 'value'}
response = requests.post('https://example.com', data=data)
print(response.text)
Ответы сервераСтатус-код запроса можно получить так:
print(response.status_code) # 200 — успешный запрос
Если ответ содержит JSON-данные, их можно преобразовать в Python-объект с помощью метода
json():
data = response.json()
Параметры запроса (params)Параметры запроса можно передавать в виде словаря в params:
params = {'q': 'python'}
response = requests.get('https://example.com/search', params=params)
Requests автоматически кодирует параметры и добавляет их к URL.
Заголовки (Headers)Заголовки запроса можно передавать в виде словаря в параметре
headers:
headers = {'User-Agent': 'my-app'}
response = requests.get('https://example.com', headers=headers)
Это полезно для указания типа контента, авторизации и других параметров.
Другие HTTP-методыRequests поддерживает все основные HTTP-методы:
🔘requests.put() — для обновления;
🔘requests.delete() — для удаления.
🔘requests.head() — для получения только заголовков ответа;
🔘requests.options() — для получения поддерживаемых сервером методов.
Подготовка запросаRequests позволяет
подготовить запрос:
from requests import Request, Session
req = Request('GET', 'https://example.com', params={'q': 'python'})
prepared = req.prepare()
with Session() as session:
response = session.send(prepared)
print(response.text)
Это полезно, если необходимо многократно отправлять одинаковые запросы с разными параметрами.
АутентификацияRequests поддерживает базовую аутентификацию с помощью параметра
auth:
from requests.auth import HTTPBasicAuth
response = requests.get('https://example.com', auth=HTTPBasicAuth('user', 'pass'))
Также поддерживаются другие методы аутентификации, такие как OAuth.
БезопасностьRequests по умолчанию проверяет SSL-сертификаты при работе с HTTPS. Если необходимо отключить проверку (не рекомендуется в производственной среде), можно использовать параметр
verify:
response = requests.get('https://example.com', verify=False)
Повторные попытки и сессииДля улучшения производительности и управления соединениями рекомендуется использовать сессии:
with requests.Session() as session:
response = session.get('https://example.com')
print(response.text)
Сессии позволяют повторно использовать соединения и сохранять параметры между запросами. Для автоматических повторных попыток в случае неудачи можно использовать библиотеку
urllib3 вместе с Requests.
#основы
@zen_of_python