Параметры HTTP запроса в Python: от базовых до продвинутых техник

Расширенные примеры работы с параметрами

В этом разделе рассматриваются нестандартные сценарии, которые часто встречаются при интеграции с веб-API.

Вложенные параметры (nested query strings)

Некоторые API ожидают параметры вида filter[name]=value. Ни одна из стандартных библиотек не поддерживает это автоматически, поэтому требуется ручное формирование.

from urllib.parse import urlencode

def nested_params(params, prefix=''):
    items = []
    for key, value in params.items():
        full_key = f'{prefix}[{key}]' if prefix else key
        if isinstance(value, dict):
            items.extend(nested_params(value, full_key).items())
        else:
            items.append((full_key, value))
    return dict(items)

params = {
    'filter': {'name': 'John', 'age': 30},
    'sort': 'name'
}
flat = nested_params(params)
query = urlencode(flat)
print(query)

filter%5Bname%5D=John&filter%5Bage%5D=30&sort=name

Пояснение: Рекурсивно строятся ключи с квадратными скобками. После декодирования %5B - это '[' , %5D - ']'.

Передача списков с разными стилями

Некоторые API поддерживают индексированные списки: filter[0][name]=aaa. Пример построения такой строки:

from urllib.parse import urlencode

items = [{'name': 'Alice'}, {'name': 'Bob'}]
params = []
for i, item in enumerate(items):
    for k, v in item.items():
        params.append((f'filter[{i}][{k}]', v))
query = urlencode(params)
print(query)

filter%5B0%5D%5Bname%5D=Alice&filter%5B1%5D%5Bname%5D=Bob

Комбинирование параметров с телом POST запроса

Иногда в одном запросе нужно отправить query-параметры в URL и данные формы в теле. Библиотека requests это позволяет:

import requests

params = {'api_key': '12345'}
data = {'username': 'user', 'password': 'pass'}
response = requests.post('https://example.com/login', params=params, data=data)
print('URL:', response.request.url)
print('Body:', response.request.body)

URL: https://example.com/login?api_key=12345
Body: username=user&password=pass

Обработка кириллицы и спецсимволов в параметрах

При работе с русскими текстами важно следить за кодировкой. Библиотека requests корректно обрабатывает UTF-8, но если сервер ожидает другую кодировку, можно задать параметр params в виде уже закодированных строк.

import requests
from urllib.parse import quote

# Ручное кодирование в cp1251
value = 'Москва'.encode('cp1251')
params = {'city': value}
# Неправильно: requests воспримет bytes как строку
response = requests.get('https://example.com', params=params)
print(response.url)  # символы будут выглядеть как %XX

# Правильный способ: передать уже закодированную строку
params = {'city': quote('Москва', encoding='cp1251')}
response = requests.get('https://example.com', params=params)
print(response.url)

https://example.com?city=%CC%EE%F1%EA%E2%E0

Использование параметров с сессиями и куками

При создании сессии с помощью requests.Session() параметры передаются аналогично, но можно установить базовые параметры для всех запросов сессии.

import requests

session = requests.Session()
session.params = {'api_key': 'secret'}
# Теперь все GET запросы через сессию будут автоматически добавлять этот параметр
resp = session.get('https://api.example.com/items')
print(resp.url)  # https://api.example.com/items?api_key=secret

Параметры для пагинации в REST API

Многие API используют параметры page и per_page или offset/limit. Пример цикла для сбора всех страниц:

import requests

base_url = 'https://api.example.com/users'
all_users = []
page = 1
per_page = 50
while True:
    params = {'page': page, 'per_page': per_page}
    response = requests.get(base_url, params=params)
    data = response.json()
    if not data:  # пустой список
        break
    all_users.extend(data)
    page += 1
print(f'Собрано {len(all_users)} пользователей')

В реальном API может быть ответ с полем `next` или `total_pages` - тогда логика строится на его основе.