API
API: ошибки и лимиты
Формат ошибок, коды ответа HTTP, коды ошибок и ограничения на количество запросов к API.
Формат ошибки
{
"error": {
"code": "plan_limit",
"message": "Interval 30s requires the Pro plan. Minimum on Starter is 60s.",
"field": "intervalSec"
}
}Коды ответа
| Статус | Значение |
|---|---|
| 400 | Некорректный JSON или запрос |
| 401 | Ключ API отсутствует или недействителен |
| 403 | У ключа нет нужного уровня доступа, или ресурс принадлежит другому пространству |
| 404 | Не найдено |
| 409 | Конфликт (повторный ключ идемпотентности с другим телом запроса) |
| 422 | Ошибка валидации, см. field |
| 429 | Превышен лимит запросов, см. Retry-After |
| 5xx | Ошибка на нашей стороне, повторите с увеличивающейся задержкой |
Коды ошибок
validation, plan_limit, not_found, forbidden_scope, rate_limited, conflict, internal.
Лимиты запросов
- 600 запросов в минуту на ключ API для чтения
- 120 запросов в минуту на ключ для записи
POST /monitors/{id}/check: 1 запрос на монитор за 10 секунд
Заголовки в каждом ответе: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.