Справка и руководства › API и интеграции › Обзор API endpoints

Обзор API endpoints

5 мин чтения · API и интеграции

Справочник всех доступных API эндпойнтов. Base URL: https://epulz.io/api/v1

Авторизация: Authorization: Bearer plz_.... Rate limit 60 запросов в минуту на токен. Сгенерируйте токен в Настройки -> API токены.

Status / auth check

GET /status - проверяет токен, возвращает email, план, количество мониторов и открытые инциденты

Monitors

GET /monitors - список всех ваших мониторов (с uptime за 24ч) GET /monitors/{id} - детали одного монитора POST /monitors - создать новый монитор (JSON: name, type, target, interval_minutes, expected_status, expected_keyword) POST /monitors/bulk - массовый импорт (макс 200 мониторов за запрос) DELETE /monitors/{id} - удалить монитор (вместе с историей проверок и инцидентов)

Checks (история)

GET /monitors/{id}/checks?limit=100 - последние N проверок (status, response time, status code, error, region). Limit 1-500, default 50.

Incidents

GET /incidents - список инцидентов. Опциональные фильтры: monitor_id, resolved (true/false), limit (1-500, default 50).

Коды ошибок

  • 401 - отсутствующий или недействительный токен
  • 403 - превышен лимит мониторов плана (при создании)
  • 404 - монитор вам не принадлежит или не существует
  • 429 - превышен rate limit (60 req/min)

Полная OpenAPI спецификация

Машиночитаемая спецификация на /api/openapi.json и интерактивная документация (Swagger UI) на /api/docs. Обе требуют входа / токена.

Следующий →
Rate limits и коды ошибок