Saltar al contingut principal
POST
curl
El reenviament s’envia a la URL emmagatzemada al lliurament, encara que hagis canviat després la URL de la destinació. Com que el payload conserva el seu event_id, un receptor que elimina duplicats per event_id tracta el reenviament com l’esdeveniment que ja coneix.
Cerca el lliurament que vols reenviar amb Llista els lliuraments de webhook de la sessió.

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

sessionId
string<uuid>
requerit

UUID de la sessió de verificació, d'usuari (KYC) o d'empresa (KYB): el session_id retornat per POST /v3/session/. El servidor el resol per a tots dos tipus de sessió.

Ha de ser un UUID vàlid. La ruta només coincideix amb UUIDs ben formats, de manera que el router d'URLs rebutja un valor mal format abans que s'executi qualsevol codi d'aplicació i la resposta és una pàgina HTML 404 en lloc de l'embolcall JSON {"detail": ...} que es mostra a continuació.

webhook_uuid
string<uuid>
requerit

UUID del lliurament que cal reenviar: el uuid d'una entrada retornada per GET /v3/session/{sessionId}/webhooks/. Ha de pertànyer a la sessió de la ruta.

Resposta

El nou lliurament, ja intentat. response_status és el que el teu endpoint ha respost aquesta vegada. El lliurament original no canvia.

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

uuid
string<uuid>
requerit

ID de lliurament. Utilitza'l com a {webhook_uuid} per obtenir o reenviar aquest lliurament.

session_id
string<uuid>
requerit

La sessió a la qual pertany el lliurament (la sessió a la ruta).

request_url
string<uri> | null
requerit

URL a la qual s'ha enviat el lliurament.

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.

status
string | null
requerit

Estat de la sessió quan es va generar l'esdeveniment, per exemple In Progress, Approved o Declined.

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
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.

created_at
string<date-time>
requerit

Quan es va crear el lliurament.

Darrera modificació el 7 de novembre del 2026