Integração · Webhooks
Nada se perde por o seu ponto de entrega ter tido uma tarde má.
A entrega é tentada cinco vezes com intervalos crescentes. Depois da última, o evento espera no diário: um webhook perdido passa a ser uma recolha em vez de uma perda.
- 5tentativas
- 2 hmaior intervalo
- 30 diasretenção do diário
Carga
Que aspecto tem uma decisão do seu lado
check.decided
POST https://your-endpoint.example/hooks
X-NNW-Signature: t=1792…,v1=4f3a…
{
"event": "check.decided",
"check_id": "chk_3Qv8ks2mPb",
"reference": "signup-55218",
"verdict": "review",
"reasons": [
{ "code": "name_match_soft", "signal": "identity", "score": 0.81 },
{ "code": "pep_tier_3", "signal": "sanctions" }
],
"evidence_bundle_id": "evb_7t2Kd9",
"policy_version": "2026-09-01",
"occurred_at": "2026-10-20T09:14:48Z"
}As assinaturas são HMAC sobre a marca temporal e o corpo. Recuse tudo aquilo cuja marca temporal se afaste mais de cinco minutos do seu relógio: é nisso que consiste toda a defesa contra a repetição.
Eventos
O que é emitido
| Evento | Quando | Leva |
|---|---|---|
check.decided | Chega-se a um veredicto | veredicto, motivos, identificador do processo |
check.expired | A recolha não chegou a concluir-se | último estado, motivo |
monitoring.hit | Uma alteração de lista ou de registo afecta um jogador existente | sinal, identificador da verificação original |
evidence.sealed | Um processo fica fechado e imutável | identificador, início do prazo de conservação |
policy.published | Entra em vigor uma nova versão de política | mercado, versão, em vigor desde |
Cada evento leva a sua própria reference: a correlação nunca depende de você guardar os nossos identificadores.