Zum Hauptinhalt springen
POST
cURL
Verwenden Sie diesen Vorgang für eine Wallet, deren Start-Antwort next_action.type = request_digital_credential enthält, etwa Google Wallet. Authentifizieren Sie sich von Ihrem Backend aus mit dem Anwendungs-API-Schlüssel, mit dem die Verifizierung gestartet wurde. Senden Sie genau das, was die Wallet zurückgegeben hat: {protocol, data} aus navigator.credentials.get im Browser oder das geparste credentialJson aus dem Android Credential Manager. Die Antwort ist für Didit verschlüsselt. Verändern Sie sie daher nicht. Didit prüft die Signatur des Ausstellers anhand seiner vertrauenswürdigen Root-Zertifikate, jeden zurückgegebenen Wert anhand seines signierten Digests sowie die Gerätesignatur über Ihren origin und diese Anfrage und entscheidet anschließend über die Verifizierung. Eine Antwort kann nur einmal eingereicht werden. Ein erneuter Einreichungsversuch liefert die bereits entschiedene Verifizierung zurück. Eine Verifizierung, die keine Wallet-Antwort entgegennimmt, antwortet mit 409 und error: "not_a_digital_credentials_wallet". Die vollständige Abfolge, einschließlich der Snippets für Browser und Android, finden Sie unter Digital-ID-Wallet-APIs.

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

request_id
string<uuid>
erforderlich

Die vom Start-Endpoint zurückgegebene request_id.

Body

Was die Wallet Ihrer Seite oder App für eine request_digital_credential-Verifizierung geantwortet hat.

response
object
erforderlich

Genau das, was die Wallet zurückgegeben hat: {protocol, data} des DigitalCredential aus navigator.credentials.get oder das geparste credentialJson des DigitalCredential von Android. Für Didit verschlüsselt; verändern Sie es nicht.

Antwort

Eine eigenständige Wallet-Verifizierung, wie sie von jedem Wallet-Endpoint beantwortet wird.

request_id
string<uuid>
erforderlich
wallet_verification
object
erforderlich
vendor_data
string | null
erforderlich
metadata
object | null
erforderlich

Das beim Start gesendete Metadaten-Objekt oder null.

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