API-Endpoints Übersicht

5 Min. Lesezeit · API & Integrationen

Referenz aller verfügbaren API-Endpunkte. Base URL: https://epulz.io/api/v1

Autorisierung: Authorization: Bearer plz_.... Rate Limit 60 Anfragen pro Minute pro Token. Token in Einstellungen -> API-Token generieren.

Status / Auth-Check

GET /status - verifiziert das Token, gibt E-Mail, Plan, Monitor-Anzahl und offene Vorfälle zurück

Monitors

GET /monitors - alle Ihre Monitore auflisten (inkl. 24h Uptime) GET /monitors/{id} - Detail eines Monitors POST /monitors - neuen Monitor erstellen (JSON: name, type, target, interval_minutes, expected_status, expected_keyword) POST /monitors/bulk - Bulk-Import (max. 200 Monitore pro Request) DELETE /monitors/{id} - Monitor löschen (inkl. Check-History und Vorfälle)

Checks (Verlauf)

GET /monitors/{id}/checks?limit=100 - letzte N Checks (Status, Response Time, Status Code, Error, Region). Limit 1-500, Standard 50.

Incidents

GET /incidents - Vorfälle auflisten. Optionale Filter: monitor_id, resolved (true/false), limit (1-500, Standard 50).

Fehlercodes

401 - fehlendes oder ungültiges Token
403 - Monitor-Limit des Plans überschritten (beim Erstellen)
404 - Monitor gehört Ihnen nicht oder existiert nicht
429 - Rate Limit überschritten (60 Req/min)

Vollständige OpenAPI-Spezifikation

Maschinenlesbare Spezifikation unter /api/openapi.json und interaktive Doku (Swagger UI) unter /api/docs. Beide erfordern Login / Token.