Работа с заголовками запросов с помощью библиотеки requests

Как задать заголовки для всех запросов в рамках одной сессии?

Использование объекта Session позволяет установить заголовки один раз и применять их ко всем запросам, выполняемым через эту сессию. Это удобно для повторяющихся заголовков, например, авторизационного токена.

import requests
session = requests.Session()
session.headers.update({
    'Authorization': 'Bearer YOUR_TOKEN',
    'Accept': 'application/json'
})
response1 = session.get('https://api.example.com/users')
response2 = session.post('https://api.example.com/users', json={'name': 'John'})
  

Python 3 requests (библиотека requests в python 3)

Метод session.headers.update() добавляет или обновляет заголовки сессии. Заголовки, переданные непосредственно в запрос, имеют приоритет над заголовками сессии.

Как подготовить запрос с заголовками, не отправляя его сразу?

Используя PreparedRequest, можно вручную собрать объект запроса, установить заголовки и затем отправить его через сессию. Это даёт полный контроль над формированием запроса.

from requests import Request, Session
url = 'https://httpbin.org/headers'
headers = {'X-Custom': 'value'}
req = Request('GET', url, headers=headers)
prepared = session.prepare_request(req)
# можно изменить prepared.headers перед отправкой
response = session.send(prepared)
  

Python requests url (выполнение запроса по url с помощью requests в python)

PreparedRequest позволяет также изменять заголовки после подготовки, если требуется динамическая корректировка.

Как передать базовую аутентификацию через заголовки вручную?

Можно вручную составить заголовок Authorization с использованием кодирования Base64. Однако requests предоставляет параметр auth, который делает это автоматически. Тем не менее, полезно знать ручной способ:

import requests
import base64
credentials = 'user:password'
encoded = base64.b64encode(credentials.encode()).decode()
headers = {'Authorization': f'Basic {encoded}'}
response = requests.get('https://httpbin.org/basic-auth/user/password', headers=headers)
  

Python requests headers (заголовки запросов в python requests)

Ошибка: неверное кодирование (пробелы, забыли декодировать из байтов) приводит к ошибке аутентификации.

Как передать cookies в заголовках запроса?

Хотя для cookies лучше использовать параметр cookies или объект CookieJar, можно передать их через заголовок Cookie напрямую:

headers = {'Cookie': 'session_id=abc123; theme=light'}
response = requests.get('https://httpbin.org/cookies', headers=headers)
  

Python requests exceptions (исключения в python requests)

Важно: если в заголовке Cookie и параметре cookies указаны одновременно, requests объединит их, но может возникнуть конфликт дублирования.

Как установить Content-Type для отправки данных?

При отправке JSON через параметр json requests автоматически устанавливает Content-Type: application/json. Однако если используется data, заголовок нужно задавать вручную:

import json
data = {'key': 'value'}
headers = {'Content-Type': 'application/json'}
response = requests.post('https://httpbin.org/post', data=json.dumps(data), headers=headers)
  

Распространённая ошибка: указать неверный Content-Type (например, application/x-www-form-urlencoded при отправке JSON) - сервер может неверно обработать данные.