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.