Saltar al contingut principal
POST
curl
Cada crida torna a lliurar el webhook. Fes que el teu endpoint sigui idempotent per event_id abans de reenviar en massa, i reenvia només els lliuraments el response_status dels quals és null, 400 o superior.
Un reenviament va a la URL que va utilitzar el lliurament original. Si has canviat la destinació a una URL nova, els lliuraments antics encara apunten a la URL anterior. Per trobar els lliuraments que vols reenviar, fes servir Llistar els lliuraments de la destinació del webhook, i consulta la guia de webhooks per a la verificació de la signatura.

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

destination_uuid
string<uuid>
requerit

UUID de la destinació a la qual s'ha enviat el lliurament.

delivery_uuid
string<uuid>
requerit

UUID del lliurament que cal reenviar: el uuid d'una entrada retornada per GET /v3/webhook/destinations/{destination_uuid}/deliveries/.

Resposta

El nou lliurament, ja intentat. response_status és el que el teu endpoint ha respost aquesta vegada (504 temps d'espera excedit, 503 fallada de connexió). El lliurament original no canvia.

Un intent de lliurament a una destinació del webhook, amb les capçaleres i el cos exactes de la sol·licitud que Didit va enviar.

uuid
string<uuid>
requerit

ID de lliurament, per a les crides de detall i de reenviament.

session_id
string<uuid> | null
requerit

Sessió de verificació d'usuaris a la qual fa referència l'esdeveniment. null per a esdeveniments de sessió d'empresa, usuari, empresa, transacció, Travel Rule i flux de treball.

request_url
string<uri> | null
requerit

URL a la qual s'ha enviat el lliurament: la URL de la destinació quan s'ha generat l'esdeveniment.

response_status
integer | null
requerit

Estat HTTP que ha retornat el teu endpoint. null mentre el lliurament està a la cua i encara no s'ha intentat. Quan no s'ha rebut cap resposta HTTP, Didit registra un estat propi: 504 quan el teu endpoint no ha respost en 5 segons, 503 per una fallada de connexió, 400 quan l'URL s'ha rebutjat per no ser segura (per exemple una adreça privada o interna), i 404 per a qualsevol altre error de sol·licitud. Un valor de 400 o superior compta com a lliurament fallit.

response_time_ms
integer | null
requerit

Temps que ha trigat l'intent, en mil·lisegons. null mentre el lliurament estigui a la cua.

Rang requerit: x >= 0
status
string | null
requerit

Estat que l'esdeveniment va indicar quan es va generar: l'estat de la sessió per a esdeveniments de sessió (per exemple Approved o In Review), l'estat de la persona o l'empresa per a esdeveniments d'usuari i d'empresa, i l'estat de la transacció per a esdeveniments de transacció. null per a esdeveniments que no inclouen cap estat.

webhook_type
enum<string>
requerit

Nom d'esdeveniment de webhook admès. Utilitza aquestes cadenes exactes a subscribed_events; els valors no admesos es rebutgen.

Opcions disponibles:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
created_at
string<date-time>
requerit

Quan es va crear el lliurament.

request_header
string
requerit

Text JSON (una cadena) de les capçaleres de sol·licitud que Didit ha enviat: Content-Type, X-Signature, X-Signature-V2, X-Signature-Simple, X-Timestamp i User-Agent. Analitza'l amb un analitzador de JSON. Conté signatures, mai el secret de signatura.

request_body
string
requerit

Text JSON (una cadena) del payload exacte que Didit ha enviat, claus ordenades, incloent-hi event_id i timestamp. Analitza'l amb un analitzador de JSON; consulta Forma del payload. Per a una clau amb àmbit sense media: read, els URL de mitjans del seu interior són null; sense sessions: write, els tokens de sessió i els enllaços de verificació allotjats són null. Un cos modificat d'aquesta manera ja no coincideix amb les seves signatures. Didit no enregistra el cos de la resposta que ha retornat el teu endpoint.

Darrera modificació el 7 de novembre del 2026