Acompanhe o que muda.

Envelope CloudEvents 1.0

json

{
  "specversion": "1.0",
  "id": "evt_demo_001",
  "source": "https://api.example.invalid",
  "type": "job.completed.v1",
  "subject": "jobs/job_demo_001",
  "time": "2026-11-01T12:00:00Z",
  "datacontenttype": "application/json",
  "tenantid": "tenant_demo",
  "correlationid": "req_demo",
  "aggregateversion": 1,
  "data": {
    "job_id": "job_demo_001",
    "result_id": "result_demo_001",
    "status": "completed",
    "usage_receipt_id": "receipt_demo"
  }
}

Baixar JSON Schema dos eventos ↓

Evento	Quando usar
document.version.published.v1	Nova revisão documental e objetos afetados.
question.updated.v1	Alteração de questão, gabarito ou campos.
certification.changed.v1	Certificado ativo, revogado ou substituído.
job.completed.v1	Job documental/classificação concluído ou parcial.
analysis.ready.v1	Análise disponível com snapshot, taxonomia e cobertura.

Verifique antes de aceitar

Contrato proposto de assinatura: headers Kuberdata-Timestamp, Kuberdata-Event-Id e Kuberdata-Signature: v1=<hex>. Assine com HMAC-SHA256 a concatenação dos bytes UTF-8 de timestamp + ponto + corpo HTTP bruto. Rejeite timestamp fora de cinco minutos e compare em tempo constante. Segredos de webhook são distintos das chaves de API; permita rotação com duas versões durante a janela acordada.

Entrega pelo menos uma vez

Persista o ID do evento e deduplique. Responda 2xx após armazenar com segurança; processe tarefas demoradas fora do handler. Eventos podem chegar fora de ordem: não sobrescreva uma revisão nova com uma antiga. A janela proposta de retries é 24 horas; depois disso, a recuperação usa o feed de mudanças.

Recupere sem lacunas

Snapshot e cursor de mudanças devem ser obtidos atomicamente. Use GET /changes para reconciliação por até 30 dias. Cursor expirado requer novo snapshot. Webhook não gera uma segunda cobrança de conteúdo. Configuração de destinos e emissão de segredos serão disponibilizadas no console do piloto.