Из чего состоит структура REST-запроса

«Из чего состоит структура REST-запроса» — вопрос из категории API и интеграции, который задают на 27% собеседований Системный Аналитик. Ниже — развёрнутый ответ с разбором ключевых моментов.

Ответ

REST-запрос состоит из нескольких ключевых компонентов:

  1. HTTP-метод – определяет тип операции (GET, POST, PUT, DELETE и др.).
  2. URL (Endpoint) – адрес ресурса, например: /api/users/123.
  3. Заголовки (Headers) – метаданные запроса (Content-Type, Authorization и др.).
  4. Тело запроса (Body) – данные для отправки (обычно в JSON или XML).
  5. Параметры – query-параметры (?page=1&limit=10) или path-параметры (/users/{id}).

Пример GET-запроса:

GET /api/users?role=admin HTTP/1.1
Host: example.com
Authorization: Bearer token123

Пример POST-запроса:

POST /api/users HTTP/1.1
Host: example.com
Content-Type: application/json

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