Zum Hauptinhalt springen
POST
curl

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

transaction_id
string<uuid>
erforderlich

Stabile Transaktions-UUID von Didit, zu der der Transfer gehört.

Body

Senden Sie als JSON oder als multipart/form-data mit den Anhängen in files.

kind
enum<string>
Standard:MESSAGE
Verfügbare Optionen:
MESSAGE,
DOCUMENT_REQUEST
body
string

Erforderlich für eine MESSAGE, es sei denn, eine Datei ist angehängt.

Maximum string length: 5000
requested_documents
string[]

Erforderlich (mindestens eines) für einen DOCUMENT_REQUEST und nur dort zulässig.

Maximum array length: 10
Maximum string length: 255
reply_to
string<uuid> | null

Eine Nachricht desselben Transfers. Eine Antwort, die ein Dokument enthält, erfüllt die Dokumentenanforderung, auf die sie antwortet.

files
file[]

Nur Multipart. Bis zu 5 Dateien mit jeweils 10 MB.

Maximum array length: 5

Antwort

Die gespeicherte Nachricht.

id
string<uuid>
kind
enum<string>
Verfügbare Optionen:
MESSAGE,
DOCUMENT_REQUEST
direction
enum<string>

OUTBOUND ist das, was die eigene Seite des Lesers gesendet hat. Im Abholportal entspricht die Richtung der Sicht der Gegenpartei.

Verfügbare Optionen:
INBOUND,
OUTBOUND
author
string

Wer es auf der jeweiligen Seite verfasst hat: die E-Mail-Adresse eines Console-Benutzers, die Bezeichnung eines API-Schlüssels oder der Name des anderen VASP.

body
string
requested_documents
string[]

Was bei einem DOCUMENT_REQUEST angefordert wird, in den Worten des Anfragenden.

reply_to
string<uuid> | null
fulfilled_at
string<date-time> | null

Wird für ein DOCUMENT_REQUEST gesetzt, sobald eine Antwort darauf ein Dokument enthält.

attachment
object | null

Das an eine Nachricht angehängte Dokument, gespeichert wie jedes andere Transaktionsdokument.

created_at
string<date-time>
Zuletzt geändert am 7. November 2026