Resumen endpoints API

5 min de lectura · API e integraciones

Referencia de todos los endpoints API disponibles. Base URL: https://epulz.io/api/v1

Autorización: Authorization: Bearer plz_.... Rate limit 60 peticiones por minuto por token. Genere un token en Ajustes -> Tokens API.

Status / auth check

GET /status - verifica el token, devuelve email, plan, número de monitores e incidentes abiertos

Monitors

GET /monitors - lista todos sus monitores (incluyendo uptime 24h) GET /monitors/{id} - detalle de un monitor POST /monitors - crear nuevo monitor (JSON: name, type, target, interval_minutes, expected_status, expected_keyword) POST /monitors/bulk - importación masiva (máx 200 monitores por petición) DELETE /monitors/{id} - eliminar monitor (incluyendo historial de checks e incidentes)

Checks (historial)

GET /monitors/{id}/checks?limit=100 - últimos N checks (status, response time, status code, error, region). Límite 1-500, default 50.

Incidents

GET /incidents - lista de incidentes. Filtros opcionales: monitor_id, resolved (true/false), limit (1-500, default 50).

Códigos de error

401 - token ausente o inválido
403 - límite de monitores del plan excedido (al crear)
404 - el monitor no le pertenece o no existe
429 - rate limit excedido (60 req/min)

Spec OpenAPI completa

Especificación legible por máquina en /api/openapi.json y documentación interactiva (Swagger UI) en /api/docs. Ambas requieren login / token.