Какие типы параметров HTTP-запроса вы знаете (path, query, header, body)? В каких кейсах используется каждый из них?

Path Parameters (Параметры пути)

Назначение

• Идентификация конкретного ресурса

• Обязательная часть URL структуры

• Используются для указания идентификаторов

Синтаксис

text

GET /api/users/{userId}
GET /api/products/{productId}/reviews/{reviewId}

Примеры использования

http

GET /api/users/123
DELETE /api/products/456
GET /api/categories/books/items/789

Особенности

• Часть маршрута URL

• Всегда обязательные

• Порядок имеет значение

• Кодируются автоматически

Query Parameters (Параметры запроса)

Назначение

• Фильтрация и поиск данных

• Пагинация и сортировка

• Опциональные параметры

• Модификация ответа

Синтаксис

text

GET /api/resources?param1=value1&param2=value2

Примеры использования

http

# Фильтрация
GET /api/users?status=active&role=admin

# Пагинация
GET /api/products?page=2&limit=20

# Сортировка
GET /api/orders?sort=created_at:desc

# Выбор полей
GET /api/articles?fields=title,content

Особенности

• Начинаются после ? в URL

• Пары ключ=значение через &

• Порядок не важен

• Подвержены ограничениям длины URL

Header Parameters (Заголовки)

Назначение

• Метаинформация о запросе

• Авторизация и аутентификация

• Управление кешированием

• Определение форматов данных

Примеры использования

http

Authorization: Bearer token123
Content-Type: application/json
Accept: application/json
Cache-Control: no-cache
User-Agent: MyApp/1.0

Основные категории заголовков

• Authentication: Authorization, API-Key

• Content: Content-Type, Content-Length

• Caching: Cache-Control, ETag

• Client: User-Agent, Accept-Language

Body Parameters (Тело запроса)

Назначение

• Передача данных для создания/обновления

• Сложные структуры данных

• Большие объемы информации

Форматы данных

json

// JSON
{
  "name": "John Doe",
  "email": "john@example.com"
}

xml

<!-- XML -->
<user>
  <name>John Doe</name>
  <email>john@example.com</email>
</user>

Примеры использования

http

POST /api/users
Content-Type: application/json

{
  "name": "John Doe",
  "email": "john@example.com"
}

Сравнение применения

Path parameters используйте для:

• Идентификаторов ресурсов

• Иерархических связей

• Обязательных параметров маршрута

Query parameters используйте для:

• Опциональной фильтрации

• Пагинации и сортировки

• Параметров поиска

• Модификации поведения API

Headers используйте для:

• Авторизации

• Метаданных запроса

• Управления кешем

• Определения форматов

Body используйте для:

• Данных создания ресурсов

• Сложных объектов

• Больших объемов данных

• Операций изменения состояния

Вывод: Правильный выбор типа параметров критически важен для создания понятного, стандартизированного и эффективного API. Path параметры идентифицируют что, query параметры определяют как, headers содержат контекст, а body передает содержимое.