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.

Body

application/json
vendor_data
string
erforderlich

Ihre interne Kennung für den Endbenutzer, auf den dieses Token beschränkt ist. Wird als Identität des Subjekts jeder mit dem Token übermittelten Transaktion erzwungen.

Beispiel:

"user-042"

ttl_seconds
integer
Standard:900

Token-Lebensdauer in Sekunden. Standardmäßig 900 (15 Minuten); maximal 86400 (24 Stunden).

Erforderlicher Bereich: x <= 86400
max_uses
integer | null

Maximale Anzahl erfolgreicher Übermittlungen, die mit diesem Token zulässig sind. Weglassen oder auf null setzen für unbegrenzte Nutzungen innerhalb der TTL.

Antwort

Das erstellte Token. Übergeben Sie sdk_token an Ihre Anwendung; es authentifiziert die geräteseitigen /v1/transactions/-Endpoints über den Header X-Transaction-Token bis expires_at.

sdk_token
string

Das Transaktions-Token mit eingeschränktem Geltungsbereich zur Übergabe an das SDK.

expires_at
string<date-time>

Wann das Token nicht mehr akzeptiert wird.

Zuletzt geändert am 7. November 2026