Zum Hauptinhalt springen
POST
cURL
Verwenden Sie diesen Endpoint, wenn Sie Verifizierungsverkehr, Zugangsdaten, Branding oder Reporting innerhalb derselben Organisation trennen müssen. Das ist besonders nützlich für Reseller, die für jeden Kunden eine Anwendung anlegen. Es eignet sich auch gut, wenn Ihr eigenes Unternehmen mehrere Produkte, Marken, Regionen, Staging- und Produktionsumgebungen oder Anwendungsfälle hat, die nicht denselben API-Schlüssel und dieselben anwendungsspezifischen Einstellungen teilen sollten.
Alle Auth-API-Endpoints verwenden https://apx.didit.me/auth/v2. Verwenden Sie den zurückgegebenen api_key als x-api-key, wenn Sie Endpoints unter https://verification.didit.me/v3/..., etwa Sitzungen und Workflows, aufrufen.

Datenstandort

Jede Anwendung speichert und verarbeitet ihre Verifizierungsdaten an einem einzigen Ort, ihrem Datenstandort, der beim Anlegen mit data_location festgelegt wird. Derzeit ist eu, die Europäische Union (Irland), der einzige Standort. Er ist auch der Standard, wenn Sie das Feld weglassen. Australien (Sydney, au) und Mexiko (mx) sind demnächst verfügbar. Eine Anfrage, die einen dieser Standorte nennt, erhält die Antwort 400 This data location is not available yet. und legt nichts an. Jede Abfrage der Anwendung gibt ihren data_location zurück. Er kann nach dem Anlegen der Anwendung nicht mehr geändert werden. Siehe Datenstandort.

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. Schlagen Sie sie mit GET /organizations/me/ nach.

Beispiel:

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

Body

application/json

Alle Felder sind optional. Wenn der Body weggelassen wird, wird eine Anwendung mit dem Standardnamen "<organization name> App" und ohne konfigurierte öffentliche URLs erstellt.

Alle Felder sind optional. Das Senden eines leeren Bodys erstellt eine Anwendung mit einem Standardnamen in der Europäischen Union.

name
string

Anzeigename der Anwendung. Standardmäßig "<organization name> App".

Beispiel:

"Acme Customer App"

website_url
string

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

URL der Nutzungsbedingungen, die im Verifizierungsablauf angezeigt wird.

Beispiel:

"https://acme.example/terms"

privacy_url
string

Im Verifizierungsablauf angezeigte Datenschutzrichtlinien-URL.

Beispiel:

"https://acme.example/privacy"

description
string

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

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"

Antwort

Anwendung erstellt. Die Antwort enthält den langlebigen api_key; speichern Sie ihn jetzt dauerhaft und verwenden Sie ihn als x-api-key-Header bei jedem Aufruf von https://verification.didit.me/v3/....

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