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.