Перейти к основному содержанию
API поддерживает заголовок X-Request-ID для трассировки запросов. Этот заголовок позволяет связать запросы и ответы в логах и упростить отладку проблем.

​
Описание

X-Request-ID — это опциональный заголовок, который позволяет передать уникальный идентификатор для трассировки запроса. Сервер возвращает этот идентификатор в ответах, что упрощает поиск соответствующих записей в логах.

​
Использование

​
Передача заголовка

Заголовок X-Request-ID передаётся в HTTP-запросе: 
GET /api/v2/catalog/lounges HTTP/1.1
Host: b2b.every.ru
Authorization: Bearer <token>
X-Request-ID: f2c8a9f6-1234-5678-9abc-def012345678

​
Формат значения

Значение заголовка — это строка произвольного формата. Рекомендуется использовать UUID для обеспечения глобальной уникальности: 
X-Request-ID: 550e8400-e29b-41d4-a716-446655440000

​
Возврат в ответах

Сервер возвращает переданный идентификатор в следующих местах:
  1. В заголовке ответа (для всех запросов): 
    HTTP/1.1 200 OK
X-Request-ID: f2c8a9f6-1234-5678-9abc-def012345678
  2. В теле ответа об ошибке (в поле request_id): 
    {
  "code": "ValidationError",
  "message": "Некорректные параметры запроса",
  "request_id": "f2c8a9f6-1234-5678-9abc-def012345678"
}

​
Важные особенности

​
Не влияет на логику

Заголовок X-Request-ID не влияет на логику исполнения запроса. Он используется исключительно для трассировки и отладки. Сервер обрабатывает запрос одинаково независимо от наличия или значения этого заголовка.

​
Опциональность

Заголовок является опциональным. Если заголовок не передан, сервер не вернёт его в ответе. Однако рекомендуется всегда передавать X-Request-ID для упрощения отладки.

​
Уникальность

Каждый запрос должен иметь уникальный идентификатор. Если вы делаете повторный запрос (например, при ретрае), рекомендуется использовать новый идентификатор, чтобы различать попытки в логах.

​
Использование при обращении в поддержку

При обращении в техническую поддержку всегда указывайте X-Request-ID из запроса, который вызвал проблему. Это позволит быстро найти соответствующие записи в логах сервера и ускорит решение проблемы. Пример обращения: 
Проблема: Получаю ошибку 500 при создании бронирования
X-Request-ID: f2c8a9f6-1234-5678-9abc-def012345678
Время запроса: 2025-11-08T10:30:00Z