Obtenir lliurament de webhook API

curl

curl -X GET 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/deliveries/66666666-7777-8888-9999-000000000001/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.webhooks.destinations.retrieve_delivery(
    "11111111-2222-3333-4444-555555555555",
    "66666666-7777-8888-9999-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.webhooks.destinations.retrieveDelivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001",
);
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Webhooks.Destinations.RetrieveDelivery(ctx, "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.webhooks().destinations().retrieveDelivery("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->webhooks->destinations->retrieveDelivery('11111111-2222-3333-4444-555555555555', '66666666-7777-8888-9999-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.webhooks.destinations.retrieve_delivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001"
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Webhooks.Destinations.RetrieveDeliveryAsync("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "66666666-7777-8888-9999-000000000001",
  "session_id": "22222222-3333-4444-5555-666666666666",
  "request_url": "https://yourapp.com/webhooks/didit",
  "response_status": 503,
  "response_time_ms": 412,
  "status": "In Progress",
  "webhook_type": "status.updated",
  "created_at": "2026-10-15T09:21:18.412345Z",
  "request_header": "{\"Content-Type\": \"application/json\", \"X-Signature\": \"a5e02a03404e1337a0198e6be15d34abbd053c658a0e51e5d0e78554213ef29b\", \"X-Signature-V2\": \"927e7cb770c94ce745939bff73f04aa200015f3bc64795ba46c2aaf78a6cedc5\", \"X-Signature-Simple\": \"e37b0d4c716c72bb5ae7127b9cc455d28ab4686e9e22312b4ec2327409a73302\", \"X-Timestamp\": \"1792056078\", \"User-Agent\": \"DiditWebhook/2.0 +https://didit.me\"}",
  "request_body": "{\"application_id\":\"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\",\"created_at\":1792056057,\"environment\":\"live\",\"event_id\":\"33333333-4444-5555-6666-777777777777\",\"sandbox_scenario\":null,\"session_id\":\"22222222-3333-4444-5555-666666666666\",\"status\":\"In Progress\",\"timestamp\":1792056078,\"vendor_data\":\"user-123\",\"webhook_type\":\"status.updated\",\"workflow_id\":\"44444444-5555-6666-7777-888888888888\",\"workflow_version\":3}"
}

GET

webhook

destinations

{destination_uuid}

deliveries

{delivery_uuid}

curl

curl -X GET 'https://verification.didit.me/v3/webhook/destinations/11111111-2222-3333-4444-555555555555/deliveries/66666666-7777-8888-9999-000000000001/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.webhooks.destinations.retrieve_delivery(
    "11111111-2222-3333-4444-555555555555",
    "66666666-7777-8888-9999-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

const result = await didit.webhooks.destinations.retrieveDelivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001",
);
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

result, err := client.Webhooks.Destinations.RetrieveDelivery(ctx, "11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Reads DIDIT_API_KEY.
Didit client = new Didit();

var result = client.webhooks().destinations().retrieveDelivery("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->webhooks->destinations->retrieveDelivery('11111111-2222-3333-4444-555555555555', '66666666-7777-8888-9999-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY.
didit = Didit::Client.new

result = didit.webhooks.destinations.retrieve_delivery(
  "11111111-2222-3333-4444-555555555555",
  "66666666-7777-8888-9999-000000000001"
)
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.Webhooks.Destinations.RetrieveDeliveryAsync("11111111-2222-3333-4444-555555555555", "66666666-7777-8888-9999-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "66666666-7777-8888-9999-000000000001",
  "session_id": "22222222-3333-4444-5555-666666666666",
  "request_url": "https://yourapp.com/webhooks/didit",
  "response_status": 503,
  "response_time_ms": 412,
  "status": "In Progress",
  "webhook_type": "status.updated",
  "created_at": "2026-10-15T09:21:18.412345Z",
  "request_header": "{\"Content-Type\": \"application/json\", \"X-Signature\": \"a5e02a03404e1337a0198e6be15d34abbd053c658a0e51e5d0e78554213ef29b\", \"X-Signature-V2\": \"927e7cb770c94ce745939bff73f04aa200015f3bc64795ba46c2aaf78a6cedc5\", \"X-Signature-Simple\": \"e37b0d4c716c72bb5ae7127b9cc455d28ab4686e9e22312b4ec2327409a73302\", \"X-Timestamp\": \"1792056078\", \"User-Agent\": \"DiditWebhook/2.0 +https://didit.me\"}",
  "request_body": "{\"application_id\":\"aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee\",\"created_at\":1792056057,\"environment\":\"live\",\"event_id\":\"33333333-4444-5555-6666-777777777777\",\"sandbox_scenario\":null,\"session_id\":\"22222222-3333-4444-5555-666666666666\",\"status\":\"In Progress\",\"timestamp\":1792056078,\"vendor_data\":\"user-123\",\"webhook_type\":\"status.updated\",\"workflow_id\":\"44444444-5555-6666-7777-888888888888\",\"workflow_version\":3}"
}

Per comprovar el codi de signatura amb un lliurament real, torna a calcular X-Signature-V2 a partir de request_body amb el secret_shared_key de la destinació, tal com s’explica a Verificació de la signatura. Per fer-ho, utilitza una clau amb accés complet: un cos amb valors ocultats ja no coincideix amb les seves signatures. Per tornar a enviar el lliurament, crida Torna a enviar el lliurament de la destinació del webhook.

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: el uuid d'una entrada retornada per GET /v3/webhook/destinations/{destination_uuid}/deliveries/.

Resposta

El lliurament, amb les seves capçaleres de sol·licitud i el cos.

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