Ошибки и лимиты

REST-эндпоинты возвращают стандартные HTTP-коды, а тело ошибки — JSON-объект с полем error.

HTTP-коды

• 200 — успех.
• 400 — некорректные параметры запроса.
• 401 / 403 — нет доступа (нет заголовка или роли).
• 404 — ресурс не найден.
• 500 — внутренняя ошибка сервера.

Формат ошибки REST

{
  "error": "Restaurant context required",
  "message": "Заголовок x-restaurant-id обязателен"
}

Формат ошибки tRPC

{
  "error": {
    "code": -32600,
    "data": { "code": "UNAUTHORIZED", "httpStatus": 401 },
    "message": "Требуется x-restaurant-id"
  }
}

Повторы запросов

• Повторяйте только идемпотентные операции (GET) и коды 5xx.
• Используйте экспоненциальную задержку (1с, 2с, 4с…).
• Не ретраьте 4xx — сначала исправьте запрос.