Riferimento API

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

Autenticazione : Authorization: Bearer cb_your_token

POST /api/v1/ingest/events

Inviare un evento di monitoring (avvio, successo, errore).

Corpo della richiesta

Campo	Tipo	Obbligatorio	Descrizione
job_key	string	✅	Identificatore univoco del job (slug). Creato automaticamente se non esiste.
event	string	✅	Tipo di evento: started, succeeded, failed, completed
environment	string		Ambiente (prod, staging, dev). Default: prod
duration_ms	integer		Durata di esecuzione in millisecondi
processed_count	integer		Numero di elementi elaborati
error_count	integer		Numero di errori riscontrati
message	string		Testo libero (dettaglio errore, riepilogo...)
event_id	string		ID univoco per deduplicare gli eventi (idempotenza)

Tipi di eventi

• started — Il job è avviato
• succeeded — Il job è riuscito
• failed — Il job è fallito
• completed — Il job è terminato (senza indicazione di successo/errore)

Risposta

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

GET /api/v1/jobs

Elenca tutti i job nel tenant.

POST /api/v1/jobs

Crea un nuovo job.

Corpo della richiesta

Campo	Tipo	Descrizione
name	string	Nome del job (lo slug viene generato automaticamente)
type	string	cron, batch, worker
environment	string	prod, staging, dev
cron_expression	string	Espressione cron standard (5 campi)
expected_cadence_minutes	integer	Alternativa a cron: intervallo in minuti
grace_period_seconds	integer	Periodo di tolleranza in secondi prima di dichiarare il job mancato (predefinito: 300)
severity	string	low, medium, high, critical

GET /api/health

Verifica che il servizio sia operativo. Nessuna autenticazione richiesta.

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

Conferma un avviso (imposta lo stato su 'acked').

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

Silenzia un avviso. Parametro: minuti (durata del silenziamento).