Referência da API

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

Autenticação : Authorization: Bearer cb_your_token

POST /api/v1/ingest/events

Envia um evento de monitoramento (start, success, failure).

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
job_key	string	✅	Identificador único do job (slug). Criado automaticamente se não existir.
event	string	✅	Tipo de evento: started, succeeded, failed, completed
environment	string		Ambiente (prod, staging, dev). Padrão: prod
duration_ms	integer		Duração da execução em milissegundos
processed_count	integer		Número de itens processados
error_count	integer		Número de erros encontrados
message	string		Mensagem de texto livre (detalhe do erro, resumo...)
event_id	string		ID único para deduplicação de eventos (idempotência)

Tipos de eventos

• started — O job iniciou
• succeeded — O job teve sucesso
• failed — O job falhou
• completed — O job completou (sem indicação de sucesso/falha)

Resposta

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

GET /api/v1/jobs

Lista todos os jobs no tenant.

POST /api/v1/jobs

Cria um novo job.

Corpo da requisição

Campo	Tipo	Descrição
name	string	Nome do job (o slug é gerado automaticamente)
type	string	cron, batch, worker
environment	string	prod, staging, dev
cron_expression	string	Expressão cron padrão (5 campos)
expected_cadence_minutes	integer	Alternativa ao cron: intervalo em minutos
grace_period_seconds	integer	Período de tolerância em segundos antes de declarar como perdido (padrão: 300)
severity	string	low, medium, high, critical

GET /api/health

Verifica se o serviço está operacional. Não requer autenticação.

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

Reconhece um alerta (define o status como 'acked').

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

Silencia um alerta. Parâmetro: minutes (duração do silêncio).