Помилки API.

Як читати статуси, не плутати 401 і 403, обробляти 429 і не приховувати проблеми інтеграції від оператора.

Коди відповідей

Поточний public API документує реальний формат помилок backend. Стандартний problem-details envelope залишається цільовою архітектурою до окремої реалізації.

400 validation error

Поле відсутнє, має неправильний тип або виходить за дозволений діапазон.

401 invalid key

Ключ відсутній, має неправильний формат, відкликаний або прострочений.

403 insufficient scope

Ключ коректний, але не має всіх scopes або клієнт не має доступного модуля.

404 tenant boundary

Ресурс не існує або не належить клієнту API-ключа.

409 state conflict

Операція конфліктує зі станом ресурсу або idempotency policy.

429 rate limit

Інтеграція перевищила допустимий темп запитів і має використати backoff.

{
  "message": "locationId is required for public menu",
  "statusCode": 400,
  "error": "Bad Request"
}
Не retry все підряд
400, 401, 403 і 404 потребують виправлення конфігурації або ключа. 429 можна повторювати тільки з backoff. 500 можна повторити обмежену кількість разів і показати оператору стан інтеграції.

Сплануйте запуск ресторану без хаосу.

Покажемо Limvero на прикладі ресторану, схожого на ваш: точки, меню, POS, кухню, QR-меню, склад, лояльність і тарифи.

Запросити демо