Aperçu des endpoints API

5 min de lecture · API et intégrations

Référence de tous les endpoints API disponibles. Base URL : https://epulz.io/api/v1

Autorisation : Authorization: Bearer plz_.... Rate limit 60 requêtes par minute par token. Générez un token dans Paramètres -> Tokens API.

Status / auth check

GET /status - vérifie le token, retourne email, plan, nombre de moniteurs et incidents ouverts

Monitors

GET /monitors - liste de tous vos moniteurs (incluant uptime 24h) GET /monitors/{id} - détail d'un moniteur POST /monitors - créer un nouveau moniteur (JSON : name, type, target, interval_minutes, expected_status, expected_keyword) POST /monitors/bulk - import en masse (max 200 moniteurs par requête) DELETE /monitors/{id} - supprimer le moniteur (avec historique des checks et incidents)

Note : la mise à jour d'un moniteur existant (PATCH) n'est actuellement pas disponible via l'API. Utilisez l'UI du dashboard, ou supprimez et recréez le moniteur.

Checks (historique)

GET /monitors/{id}/checks?limit=100 - N derniers checks (status, response time, status code, error, region). Limit 1-500, défaut 50.

Incidents

GET /incidents - liste des incidents. Filtres optionnels : monitor_id, resolved (true/false), limit (1-500, défaut 50).

Codes d'erreur

401 - token manquant ou invalide
403 - limite de moniteurs du plan dépassée (à la création)
404 - le moniteur ne vous appartient pas ou n'existe pas
429 - rate limit dépassé (60 req/min)

Spécification OpenAPI complète

Spécification lisible par machine sur /api/openapi.json et docs interactives (Swagger UI) sur /api/docs. Les deux nécessitent connexion / token.