Référence API

Base URL : https://cronbeacon.com/api/v1

Authentification : Authorization: Bearer cb_your_token

POST /api/v1/ingest/events

Envoyer un event de monitoring (démarrage, succès, échec).

Corps de la requête

Champ	Type	Requis	Description
job_key	string	✅	Identifiant unique du job (slug). Créé automatiquement s'il n'existe pas.
event	string	✅	Type d'event : started, succeeded, failed, completed
environment	string		Environnement (prod, staging, dev). Défaut : prod
duration_ms	integer		Durée d'exécution en millisecondes
processed_count	integer		Nombre d'éléments traités
error_count	integer		Nombre d'erreurs rencontrées
message	string		Message libre (détail erreur, résumé...)
event_id	string		ID unique pour dédupliquer les events (idempotence)

Types d'events

• started — Le job a démarré
• succeeded — Le job a réussi
• failed — Le job a échoué
• completed — Le job est terminé (sans indication de succès/échec)

Réponse

{
  "status": "ok",
  "run_id": "01924f8a-...",
  "job_id": "01924f8a-...",
  "event": "succeeded",
  "created": true
}

GET /api/v1/jobs

Lister tous les jobs du tenant.

POST /api/v1/jobs

Créer un nouveau job.

Corps de la requête

Champ	Type	Description
name	string	Nom du job (le slug est généré automatiquement)
type	string	cron, batch, worker
environment	string	prod, staging, dev
cron_expression	string	Expression cron standard (5 champs)
expected_cadence_minutes	integer	Alternative au cron : intervalle en minutes
grace_period_seconds	integer	Marge en secondes avant de déclarer un missed (défaut: 300)
severity	string	low, medium, high, critical

GET /api/health

Vérifier que le service est opérationnel. Aucune authentification requise.

POST /api/v1/alerts/{id}/ack

Acquitter une alerte (passe en statut 'acked').

POST /api/v1/alerts/{id}/mute

Mettre une alerte en sourdine. Paramètre : minutes (durée du mute).