{
  "subject_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "report_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "old_score": 742,
  "new_score": 688,
  "old_band": "B",
  "new_band": "B"
}

Cambió el score qscore

Un informe Qscore recién generado produjo un score distinto al último conocido del sujeto (p. ej. en una re-consulta de monitoreo o una compra nueva). Se emite solo cuando el score efectivamente cambia; el payload lleva el par score/banda anterior y nuevo para que decidas si actuar. Suscríbete a este evento para monitorear un sujeto en el tiempo sin polling.

Cada entrega incluye X-Webhook-Event, X-Webhook-Event-ID, X-Webhook-Delivery-ID, X-Webhook-Timestamp y X-Webhook-Signature = hex(HMAC-SHA256(secret, timestamp + "." + body)). Responde 2xx; hasta 5 intentos con backoff incremental.

WEBHOOK

risk_score_changed

{
  "subject_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "report_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "old_score": 742,
  "new_score": 688,
  "old_band": "B",
  "new_band": "B"
}

Autorizaciones

Authorization

string

header

requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Cuerpo

application/json

subject_id

string

report_id

string

old_score

integer

new_score

integer

old_band

string

new_band

string

Respuesta

200

Devuelve cualquier 2xx para confirmar la entrega.