Zum Hauptinhalt springen
GET
cURL

Autorisierungen

Authorization
string
header
erforderlich

RS256-signiertes JWT access_token, das von POST /programmatic/login/ oder POST /programmatic/verify-email/ zurückgegeben wird. Als Authorization: Bearer <access_token> senden. Die Standardlebensdauer beträgt 86400 Sekunden (24 Stunden). Dieses Token ist nur für die Account-Management-Endpoints auf apx.didit.me/auth/v2 gültig. Die Verifizierungs-API (verification.didit.me/v3) verwendet stattdessen den langlebigen api_key als x-api-key.

Pfadparameter

org_id
string<uuid>
erforderlich

UUID der Organisation, der die Anwendung gehört.

Beispiel:

"a1b2c3d4-5678-90ab-cdef-111111111111"

app_id
string<uuid>
erforderlich

UUID der Anwendung, deren Anmeldedaten Sie abrufen möchten.

Beispiel:

"b2c3d4e5-6789-01bc-defg-222222222222"

Antwort

Anwendungsdatensatz einschließlich client_id und api_key.

Vollständiger Anwendungsdatensatz. uuid, client_id und api_key ändern sich nach der Erstellung nie. data_location ändert sich ebenfalls nicht, außer einmalig bei der mit Ihrer Organisation erstellten Live-Anwendung, bevor diese verwendet wird (siehe Aktualisierungsanfrage).

uuid
string<uuid>

Anwendungs-UUID. In nachfolgenden Aufrufen als {app_id} verwenden.

Beispiel:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

In der Didit Console angezeigter Anzeigename der Anwendung.

Beispiel:

"Acme Production App"

client_id
string

Öffentlicher Client-Identifikator, der sicher in OAuth-ähnliche Abläufe eingebunden werden kann.

Beispiel:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Langlebiges Secret (auch client_secret genannt). Als x-api-key-Header für jeden Aufruf an https://verification.didit.me/v3/... verwenden (Sitzungen, Workflows, AML usw.). Wie Zugangsdaten behandeln; niemals clientseitig offenlegen. Neue Schlüssel beginnen mit sk_live_ (Live-Anwendung) oder sk_test_ (Sandbox-Anwendung), gefolgt von 43 URL-sicheren Zeichen (Buchstaben, Ziffern, - und _). Schlüssel, die vor diesem Format erstellt wurden, haben kein Präfix und funktionieren weiterhin unverändert. Für 72 Stunden nach der Wiederherstellung Ihres Kontos geben Auflisten, Abrufen und Aktualisieren hier eine leere Zeichenkette anstelle des Schlüssels zurück.

Beispiel:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

Mit dieser Anwendung verknüpfte Website- oder App-URL.

Beispiel:

"https://acme.example"

redirect_uris
string[]

Zulässige Weiterleitungs-URIs für Weiterleitungs-Workflows im OAuth-Stil und Verifizierungs-Weiterleitungs-Workflows.

Beispiel:
terms_url
string | null

URL der Nutzungsbedingungen, die im Verifizierungsablauf angezeigt wird.

Beispiel:

"https://acme.example/terms"

privacy_url
string | null

Im Verifizierungsablauf angezeigte Datenschutzrichtlinien-URL.

Beispiel:

"https://acme.example/privacy"

description
string | null

Interne Beschreibung für die Anwendung (wird Endbenutzern nicht angezeigt).

created_at
string<date-time>
Beispiel:

"2025-06-01T10:00:00Z"

data_location
enum<string>

Wo die Verifizierungsdaten der Anwendung gespeichert und verarbeitet werden, ausgewählt bei der Erstellung der Anwendung. eu ist die Europäische Union (Irland), die Standardeinstellung. au (Australien, Sydney) und mx (Mexiko) folgen in Kürze: Eine Anfrage, die diese angibt, führt zu einer 400-Antwort This data location is not available yet.. Die Sandbox-Anwendung einer Organisation befindet sich immer in der Europäischen Union.

Verfügbare Optionen:
eu,
au,
mx
Beispiel:

"eu"

products
object[]
read-only

Die Produkte der Anwendung. Immer alle drei, in dieser Reihenfolge: identity, transactions, authentication. Eine neue Anwendung hat identity aktiviert, wobei jedes Modul eingeschaltet ist, und transactions sowie authentication deaktiviert. Schreibgeschützt: Ein products-Schlüssel im Body einer Erstellung oder Aktualisierung wird ignoriert.

Beispiel:
Zuletzt geändert am 7. November 2026