Súgó és útmutatók › API és integrációk › API endpointok áttekintése

API endpointok áttekintése

5 perc olvasás · API és integrációk

Az összes elérhető API végpont áttekintése. Base URL: https://epulz.io/api/v1

Autorizáció: Authorization: Bearer plz_.... Rate limit 60 kérés/perc tokenenként. Tokent a Beállítások -> API tokenek menüben generálhat.

Status / auth check

GET /status - ellenőrzi a tokent, visszaadja az email, terv, monitorok száma és nyitott incidensek

Monitors

GET /monitors - összes monitor listája (24h uptime-mal) GET /monitors/{id} - egy monitor részletei POST /monitors - új monitor létrehozása (JSON: name, type, target, interval_minutes, expected_status, expected_keyword) POST /monitors/bulk - tömeges import (max 200 monitor kérésenként) DELETE /monitors/{id} - monitor törlése (checkek és incidensek történetével együtt)

Checks (előzmények)

GET /monitors/{id}/checks?limit=100 - utolsó N ellenőrzés (status, response time, status code, error, region). Limit 1-500, alapértelmezett 50.

Incidents

GET /incidents - incidensek listája. Opcionális szűrők: monitor_id, resolved (true/false), limit (1-500, alapértelmezett 50).

Hibakódok

  • 401 - hiányzó vagy érvénytelen token
  • 403 - a csomag monitorlimitje túllépve (létrehozáskor)
  • 404 - a monitor nem az Öné vagy nem létezik
  • 429 - rate limit túllépve (60 kérés/perc)

Teljes OpenAPI spec

Gép által olvasható specifikáció a /api/openapi.json címen, interaktív dokumentáció (Swagger UI) a /api/docs címen. Mindkettő bejelentkezést / tokent igényel.

Következő →
Rate limitek és hibakódok