Коды ошибок
Справочник кодов ошибок API GuestMe и рекомендации по обработке
При работе с API GuestMe вы можете столкнуться с ошибками. В этом разделе описаны стандартные HTTP-коды и специфические коды ошибок API.
HTTP-коды ответов
Код | Статус | Описание |
|---|---|---|
| OK | Запрос выполнен успешно |
| Bad Request | Некорректные параметры запроса |
| Unauthorized | Отсутствует или недействителен токен авторизации |
| Forbidden | Недостаточно прав для выполнения операции |
| Not Found | Ресурс не найден |
| Conflict | Конфликт — например, дублирование бронирования |
| Internal Server Error | Внутренняя ошибка сервера |
Коды ошибок API
В теле ответа с ошибкой содержится код, позволяющий определить причину:
Код ошибки | HTTP-статус | Описание |
|---|---|---|
| 400 | Дата бронирования в прошлом или вне расписания ресторана |
| 400 | Ресторан не подключил канал привлечения гостей |
| 400 | Шлюз подтверждения телефона отключён для ресторана |
| 400 | Неверный код подтверждения телефона |
| 400 | Код подтверждения ещё действителен, повторный запрос невозможен |
| 409 | Попытка отменить бронирование в статусе, не допускающем отмену |
| 409 | У гостя уже есть активное бронирование в этом ресторане |
| 404 | Ресторан с указанным ID не найден |
| 404 | Бронирование с указанным ID не найдено |
| 400 | Некорректный формат номера телефона |
| 401 | Токен отсутствует, истёк или недействителен |
Рекомендации по обработке
- При получении 401 — обновите access_token и повторите запрос
- При получении 400 — проверьте параметры запроса, обратите внимание на код ошибки в ответе
- При получении 409 — конфликт бизнес-логики, проверьте текущее состояние ресурса
- При получении 500 — повторите запрос через некоторое время
Ответ с ошибкой содержит JSON с полем error (код ошибки) и message (описание на английском языке).