Начало работы
Ошибки
Коды ответов и формат ошибок валидации.
| Код | Когда |
|---|---|
| 200 | запрос выполнен успешно |
| 403 | доступ запрещён: неверные заголовки, объект другого аккаунта, заблокированный аккаунт |
| 404 | объект не найден в этом аккаунте |
| 422 | ошибка валидации или нарушение бизнес-правила (слот занят, сотрудник неактивен) |
| 429 | превышен лимит запросов: 600 в минуту на ключ API |
Формат 422
{
"message": "Это время уже занято.",
"errors": {
"booking": ["Это время уже занято."]
}
}
errors — объект, где ключ — имя поля запроса, значение — список сообщений. Сообщения локализованы по языку аккаунта.
Лимит запросов
На один ключ API действует лимит 600 запросов в минуту. Каждый ответ содержит заголовки X-RateLimit-Limit и X-RateLimit-Remaining; при превышении API отвечает 429 с заголовком Retry-After. Ответы 403 формируются до проверки лимита и в нём не учитываются.