Какие бывают параметры HTTP-запроса: path, query, header и body — когда применять каждый?

Типы параметров HTTP-запроса и сценарии их применения

• Path параметры
• Являются частью URL и указывают на определённый ресурс
• Применяются для идентификации объекта, например /users/{id}
• Query параметры
• Указываются после ? в формате ключ-значение
• Нужны для фильтрации, пагинации и сортировки результатов
• Header параметры
• Содержат метаданные: данные авторизации, тип контента, настройки кэша
• Описывают условия и формат взаимодействия клиента с сервером
• Body параметры
• Представляют содержимое запроса и часто используются в POST/PUT
• Передают данные формы, JSON и файлы

Назначение у каждого типа своё: path выбирает ресурс, query уточняет условия запроса, header управляет параметрами протокола, а body содержит передаваемые данные.

Подробный ответ

Основной ответ

В составе HTTP-запроса обычно рассматривают четыре категории параметров: path parameters, query parameters, headers и body. Они решают разные задачи и позволяют клиенту передавать серверу данные в соответствии с конкретным сценарием.

Path parameters включаются непосредственно в URL и обозначают конкретный ресурс, например, /users/{userId}. Такой подход используют, когда нужно обратиться к определённому объекту или коллекции. В REST API через path-параметры чаще всего передают id, имя либо иной уникальный идентификатор ресурса.

Query parameters размещаются после ? в URL (/search?q=keyword&page=2). С их помощью задают фильтры, сортировку и пагинацию, а также передают необязательные данные, не меняя саму структуру URL.

Headers — это метаданные запроса. Они не определяют, к какому ресурсу обращаются, а описывают свойства запроса или клиента: авторизацию (Authorization), формат содержимого (Content-Type), язык (Accept-Language), параметры кэширования и другие характеристики.

Body содержит данные запроса и обычно используется в запросах POST, PUT и PATCH. В него помещают сложные или объёмные структуры, часто представленные в форматах JSON, XML или form-data. Этот способ применяют при создании и обновлении ресурсов.

Ключевые моменты

• Path параметры задают понятную и строгую структуру адреса ресурса, однако их набор и формат, как правило, заранее определены.
• Query параметры обеспечивают гибкость: с их помощью можно менять выдачу и задавать опции, не изменяя URL ресурса.
• Headers передают сведения о протоколе и безопасности, используются для управления сессиями и content negotiation.
• Body особенно важен для передачи сложных структур, в том числе в REST и GraphQL. Его размер обычно ограничен, а формат необходимо корректно обозначать с помощью Content-Type.

Практический контекст

В прикладных проектах — например, в API-сервисах на Node.js с Express или в Spring Boot — path-параметры обычно содержат ключевые идентификаторы, query-параметры задают фильтры и настройки пагинации, headers передают токены аутентификации, а body содержит JSON для создания или обновления сущностей. Такое разделение упрощает поддержку, тестирование и обеспечение безопасности API.