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

Question

Path parameters идентифицируют конкретный ресурс в URL (/users/123). Query parameters используются для фильтрации, сортировки и пагинации (?page=1). Headers передают метаинформацию: авторизацию, кеширование, тип контента. Body содержит данные для создания или обновления ресурсов в форматах JSON, XML. Каждый тип имеет специфичное применение в REST API.

YeaHub · Accepted Answer

Path Parameters (Параметры пути)НазначениеИдентификация конкретного ресурсаОбязательная часть URL структурыИспользуются для указания идентификаторовСинтаксисtextGET /api/users/{userId} GET /api/products/{productId}/reviews/{reviewId}Примеры использованияhttpGET /api/users/123 DELETE /api/products/456 GET /api/categories/books/items/789ОсобенностиЧасть маршрута URLВсегда обязательныеПорядок имеет значениеКодируются автоматическиQuery Parameters (Параметры запроса)НазначениеФильтрация и поиск данныхПагинация и сортировкаОпциональные параметрыМодификация ответаСинтаксисtextGET /api/resources?param1=value1¶m2=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Пары ключ=значение через &Порядок не важенПодвержены ограничениям длины URLHeader Parameters (Заголовки)НазначениеМетаинформация о запросеАвторизация и аутентификацияУправление кешированиемОпределение форматов данныхПримеры использованияhttpAuthorization: Bearer token123 Content-Type: application/json Accept: application/json Cache-Control: no-cache User-Agent: MyApp/1.0Основные категории заголовковAuthentication: Authorization, API-KeyContent: Content-Type, Content-LengthCaching: Cache-Control, ETagClient: User-Agent, Accept-LanguageBody Parameters (Тело запроса)НазначениеПередача данных для создания/обновленияСложные структуры данныхБольшие объемы информацииФорматы данныхjson// JSON { "name": "John Doe", "email": "john@example.com" }xml John Doe john@example.com Примеры использованияhttpPOST /api/users Content-Type: application/json { "name": "John Doe", "email": "john@example.com" }Сравнение примененияPath parameters используйте для:Идентификаторов ресурсовИерархических связейОбязательных параметров маршрутаQuery parameters используйте для:Опциональной фильтрацииПагинации и сортировкиПараметров поискаМодификации поведения APIHeaders используйте для:АвторизацииМетаданных запросаУправления кешемОпределения форматовBody используйте для:Данных создания ресурсовСложных объектовБольших объемов данныхОпераций изменения состоянияВывод: Правильный выбор типа параметров критически важен для создания понятного, стандартизированного и эффективного API. Path параметры идентифицируют что, query параметры определяют как, headers содержат контекст, а body передает содержимое.