Panoramica endpoint API

5 min di lettura · API e integrazioni

Riferimento di tutti gli endpoint API disponibili. Base URL: https://epulz.io/api/v1

Autorizzazione: Authorization: Bearer plz_.... Rate limit 60 richieste al minuto per token. Genera un token in Impostazioni -> Token API.

Status / auth check

GET /status - verifica il token, restituisce email, piano, numero di monitor e incidenti aperti

Monitors

GET /monitors - elenco di tutti i tuoi monitor (incluso uptime 24h) GET /monitors/{id} - dettaglio di un monitor POST /monitors - crea nuovo monitor (JSON: name, type, target, interval_minutes, expected_status, expected_keyword) POST /monitors/bulk - import di massa (max 200 monitor per richiesta) DELETE /monitors/{id} - elimina monitor (inclusi storico check e incidenti)

Checks (storico)

GET /monitors/{id}/checks?limit=100 - ultimi N check (status, response time, status code, error, region). Limite 1-500, default 50.

Incidents

GET /incidents - elenco incidenti. Filtri opzionali: monitor_id, resolved (true/false), limit (1-500, default 50).

Codici di errore

401 - token mancante o non valido
403 - limite monitor del piano superato (alla creazione)
404 - il monitor non ti appartiene o non esiste
429 - rate limit superato (60 req/min)

Spec OpenAPI completa

Specifica machine-readable su /api/openapi.json e docs interattivi (Swagger UI) su /api/docs. Entrambi richiedono login / token.