Zum Hauptinhalt springen
POST
curl
Jeder Aufruf stellt den Webhook erneut zu. Machen Sie Ihren Endpoint idempotent in Bezug auf event_id, bevor Sie Zustellungen in großer Zahl erneut senden, und senden Sie nur Zustellungen erneut, deren response_status null oder 400 oder höher ist.
Eine erneute Zustellung geht an die URL, die die ursprüngliche Zustellung verwendet hat. Wenn Sie das Webhook-Ziel auf eine neue URL verschoben haben, verweisen die alten Zustellungen weiterhin auf die alte URL. Die erneut zu sendenden Zustellungen finden Sie mit Webhook-Ziel-Zustellungen auflisten. Informationen zur Signaturprüfung finden Sie im Webhooks-Leitfaden.

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

destination_uuid
string<uuid>
erforderlich

UUID des Ziels, an das die Zustellung gesendet wurde.

delivery_uuid
string<uuid>
erforderlich

UUID der erneut zu sendenden Zustellung: die uuid eines von GET /v3/webhook/destinations/{destination_uuid}/deliveries/ zurückgegebenen Eintrags.

Antwort

Die neue Zustellung, bereits versucht. response_status ist das, was Ihr Endpoint diesmal geantwortet hat (504 Zeitüberschreitung, 503 Verbindungsfehler). Die ursprüngliche Zustellung bleibt unverändert.

Ein Zustellungsversuch an ein Webhook-Ziel mit den exakten Anfrage-Headern und dem Body, den Didit gesendet hat.

uuid
string<uuid>
erforderlich

Zustellungs-ID für den Abruf von Details und das erneute Senden.

session_id
string<uuid> | null
erforderlich

Benutzerverifizierungssitzung, auf die sich das Ereignis bezieht. null bei Ereignissen zu Unternehmenssitzungen, Benutzern, Unternehmen, Transaktionen, Travel Rule und Workflows.

request_url
string<uri> | null
erforderlich

URL, an die die Zustellung gesendet wurde: die URL des Ziels zum Zeitpunkt der Ereigniserstellung.

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.

response_time_ms
integer | null
erforderlich

Dauer des Versuchs in Millisekunden. null, solange die Zustellung in der Warteschlange ist.

Erforderlicher Bereich: x >= 0
status
string | null
erforderlich

Status, den das Ereignis bei seiner Erstellung gemeldet hat: der Sitzungsstatus für Sitzungsereignisse (zum Beispiel Approved oder In Review), der Status der Person oder des Unternehmens für Benutzer- und Unternehmensereignisse und der Transaktionsstatus für Transaktionsereignisse. null für Ereignisse ohne Status.

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
created_at
string<date-time>
erforderlich

Wann die Zustellung erstellt wurde.

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.

Zuletzt geändert am 7. November 2026