Vai al contenuto principale
POST
cURL
Usa questa operazione per un wallet la cui risposta di avvio contiene next_action.type = request_digital_credential, come Google Wallet. Autenticati con la chiave API dell’applicazione che ha avviato la verifica, dal tuo backend. Invia esattamente ciò che il wallet ha restituito: {protocol, data} da navigator.credentials.get nel browser, oppure il credentialJson analizzato dal Credential Manager di Android. La risposta è cifrata per Didit, quindi non modificarla. Didit verifica la firma dell’emittente rispetto alle proprie radici attendibili per gli emittenti, ogni valore restituito rispetto al suo digest firmato e la firma del dispositivo sul tuo origin e su questa richiesta, poi determina l’esito della verifica. Una risposta può essere inviata una sola volta. Un secondo invio restituisce la verifica che è già stata decisa. Una verifica che non accetta una risposta del wallet restituisce 409 con error: "not_a_digital_credentials_wallet". Per la sequenza completa, inclusi gli snippet per browser e Android, vedi API per wallet di identità digitale.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

request_id
string<uuid>
obbligatorio

Il request_id restituito dall'endpoint di avvio.

Corpo

Cosa ha risposto il wallet alla tua pagina o app, per una verifica request_digital_credential.

response
object
obbligatorio

Esattamente ciò che il wallet ha restituito: {protocol, data} di DigitalCredential da navigator.credentials.get, o il credentialJson analizzato di DigitalCredential di Android. Crittografato per Didit; non modificarlo.

Risposta

Una verifica del wallet autonoma, così come restituita da ciascun endpoint di wallet.

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

L'oggetto dei metadati inviato all'avvio, o null.

created_at
string<date-time>
obbligatorio
Ultima modifica il 7 novembre 2026