Zum Hauptinhalt springen
POST
curl
Die erneute Zustellung geht an die URL, die in der Zustellung gespeichert ist, auch wenn Sie die URL des Webhook-Ziels seitdem geändert haben. Da der Payload seine event_id behält, behandelt ein Empfänger, der anhand von event_id dedupliziert, die erneute Zustellung als das Webhook-Ereignis, das er bereits kennt.
Suchen Sie die Zustellung, die Sie erneut senden möchten, mit Session-Webhook-Zustellungen auflisten.

Autorisierungen

x-api-key
string
header
erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

sessionId
string<uuid>
erforderlich

UUID der Verifizierungssitzung, Benutzer (KYC) oder Unternehmen (KYB): die von POST /v3/session/ zurückgegebene session_id. Der Server löst sie für beide Sitzungstypen auf.

Muss eine gültige UUID sein. Die Route stimmt nur mit wohlgeformten UUIDs überein, sodass ein fehlerhafter Wert vom URL-Router abgelehnt wird, bevor Anwendungscode ausgeführt wird, und die Antwort eine 404-HTML-Seite anstelle des unten gezeigten JSON-Antwortobjekts {"detail": ...} ist.

webhook_uuid
string<uuid>
erforderlich

UUID der erneut zu sendenden Zustellung: die uuid eines von GET /v3/session/{sessionId}/webhooks/ zurückgegebenen Eintrags. Sie muss zu der Sitzung im Pfad gehören.

Antwort

Die neue Zustellung, bereits versucht. response_status ist das, was Ihr Endpoint diesmal geantwortet hat. Die ursprüngliche Zustellung bleibt unverändert.

Ein für eine Verifizierungssitzung aufgezeichneter Webhook-Zustellversuch mit den exakten Anfrage-Headern und dem Body, die Didit gesendet hat.

uuid
string<uuid>
erforderlich

Zustellungs-ID. Verwenden Sie diese als {webhook_uuid}, um diese Zustellung abzurufen oder erneut zu senden.

session_id
string<uuid>
erforderlich

Die Sitzung, zu der die Zustellung gehört (die Sitzung im Pfad).

request_url
string<uri> | null
erforderlich

URL, an die die Zustellung gesendet wurde.

response_status
integer | null
erforderlich

HTTP-Status, den Ihr Endpoint zurückgegeben hat. null, solange die Zustellung in der Warteschlange steht und noch nicht versucht wurde. Wenn keine HTTP-Antwort empfangen wurde, erfasst Didit einen eigenen Status: 504, wenn Ihr Endpoint nicht innerhalb von 5 Sekunden geantwortet hat, 503 bei einem Verbindungsfehler, 400, wenn die URL als unsicher abgelehnt wurde (z. B. eine private oder interne Adresse), und 404 bei jedem anderen Anfragefehler. 400 oder höher gilt als fehlgeschlagene Zustellung.

status
string | null
erforderlich

Sitzungsstatus zum Zeitpunkt der Ereigniserstellung, beispielsweise In Progress, Approved oder Declined.

webhook_type
enum<string>
erforderlich

Name des unterstützten Webhook-Ereignisses. Verwenden Sie genau diese Zeichenfolgen in subscribed_events; nicht unterstützte Werte werden abgelehnt.

Verfügbare Optionen:
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
erforderlich

JSON-Text (ein String) der von Didit gesendeten Anfrage-Header: Content-Type, X-Signature, X-Signature-V2, X-Signature-Simple, X-Timestamp und User-Agent. Parsen Sie ihn mit einem JSON-Parser. Er enthält Signaturen, niemals das Signiergeheimnis.

request_body
string
erforderlich

JSON-Text (ein String) der exakten Payload, die Didit gesendet hat, mit sortierten Schlüsseln, einschließlich event_id und timestamp. Parsen Sie ihn mit einem JSON-Parser; siehe Payload-Struktur. Bei einem berechtigungseingeschränkten Schlüssel ohne media: read sind Medien-URLs darin null; ohne sessions: write sind Sitzungs-Token und Links zur gehosteten Verifizierungsseite null. Ein auf diese Weise veränderter Body stimmt nicht mehr mit seinen Signaturen überein. Didit speichert den von Ihrem Endpoint zurückgegebenen Antwort-Body nicht.

created_at
string<date-time>
erforderlich

Wann die Zustellung erstellt wurde.

Zuletzt geändert am 7. November 2026