Přehled API endpointů

5 min čtení · API a integrace

Přehled všech dostupných API endpointů. Base URL: https://epulz.io/api/v1

Autorizace: Authorization: Bearer plz_.... Rate limit 60 požadavků za minutu na token. Token vygenerujte v Nastavení -> API tokeny.

Status / auth check

GET /status - ověří token, vrátí email, plán, počet monitorů a otevřených incidentů

Monitors

GET /monitors - seznam všech vašich monitorů (vč. uptime 24 h) GET /monitors/{id} - detail jednoho monitoru POST /monitors - vytvoř nový monitor (JSON: name, type, target, interval_minutes, expected_status, expected_keyword) POST /monitors/bulk - hromadný import (max 200 monitorů na požadavek) DELETE /monitors/{id} - smaž monitor (vč. historie checků a incidentů)

Checks (historie)

GET /monitors/{id}/checks?limit=100 - posledních N kontrol (status, response time, status code, error, region). Limit 1-500, default 50.

Incidents

GET /incidents - seznam incidentů. Volitelné filtry: monitor_id, resolved (true/false), limit (1-500, default 50).

Chybové kódy

401 - chybějící nebo neplatný token
403 - překročen limit monitorů vašeho plánu (při vytváření)
404 - monitor nepatří vám nebo neexistuje
429 - překročen rate limit (60 req/min)

Plný OpenAPI spec

Strojově čitelná specifikace na /api/openapi.json a interaktivní dokumentace (Swagger UI) na /api/docs. Obě vyžadují přihlášení / token.