Zum Hauptinhalt springen
PATCH
cURL
Verwenden Sie diesen Endpoint, damit jede Anwendung zum Kunden, zur Marke, zur Umgebung oder zum internen Anwendungsfall passt, den sie repräsentiert. Für Reseller ermöglicht dieser Endpoint, jede Kundenanwendung umzubenennen oder zu aktualisieren, ohne Zugangsdaten zwischen Kunden zu teilen. Für direkte Kunden hilft er dabei, Produkte, Regionen oder Umgebungen voneinander zu trennen, während alles unter einer Organisation bleibt.
Dieser Endpoint aktualisiert die Metadaten der Anwendung. Der api_key bleibt unverändert, sofern Sie die Zugangsdaten nicht separat rotieren.

Datenstandort

Der Datenstandort einer Anwendung (data_location) wird beim Anlegen der Anwendung festgelegt und lässt sich danach nicht mehr ändern: Eine Aktualisierung, die den bereits vorhandenen Standort angibt, wird akzeptiert, jeder andere Standort wird mit 400 beantwortet. Die einzige Ausnahme ist die Live-Anwendung, die zusammen mit Ihrer Organisation angelegt wird, bei der Registrierung oder durch die E-Mail-Verifizierung. Die erste Aktualisierung, die einen data_location angibt, legt dessen Standort einmalig fest, sofern keiner der API-Schlüssel der Anwendung verwendet wurde und die Anwendung keine Sitzung für eine Verifizierung hat. Der Schritt Benennen Sie Ihre erste Anwendung in der Konsole nutzt dies, um den dort gewählten Standort zu speichern. Derzeit ist als Standort nur eu verfügbar, die Europäische Union (Irland).

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 zu aktualisierenden Anwendung.

Beispiel:

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

Body

application/json

Senden Sie nur die Felder, die Sie ändern möchten. PATCH-Semantik: Fehlende Felder bleiben erhalten.

PATCH-Body für Anwendungsmetadaten. Senden Sie nur die Felder, die Sie ändern möchten; weggelassene Felder bleiben erhalten. uuid, client_id und api_key können nicht aktualisiert werden. products ist schreibgeschützt: ein products-Schlüssel im Body wird ignoriert. data_location kann nach der Erstellung der Anwendung nicht mehr geändert werden: Die Angabe des bereits vorhandenen Standorts wird akzeptiert, und jeder andere Standort gibt 400 zurück. Die einzige Ausnahme ist die mit Ihrer Organisation erstellte Produktionsanwendung: Die erste Aktualisierung, die eine data_location benennt, wählt diese einmalig aus, solange noch kein API-Schlüssel der Anwendung verwendet wurde und sie keine Verifizierungssitzung hat.

name
string

Anzeigename der Anwendung.

Beispiel:

"Acme Production App"

website_url
string

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

Beispiel:

"https://app.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.

privacy_url
string

Im Verifizierungsablauf angezeigte Datenschutzrichtlinien-URL.

description
string

Interne Beschreibung für die Anwendung.

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 aktualisiert. Die Antwort ist der vollständige Anwendungsdatensatz nach der Änderung, einschließlich products; uuid, client_id und api_key bleiben unverändert.

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