Vai al contenuto principale
GET
cURL

Autorizzazioni

Authorization
string
header
obbligatorio

access_token JWT firmato con RS256 restituito da POST /programmatic/login/ o POST /programmatic/verify-email/. Invia come Authorization: Bearer <access_token>. La durata predefinita è di 86400 secondi (24 ore). Questo token è valido solo per gli endpoint di Account Management su apx.didit.me/auth/v2. L'API di verifica (verification.didit.me/v3) utilizza invece la api_key a lunga durata come x-api-key.

Parametri del percorso

org_id
string<uuid>
obbligatorio

UUID dell'organizzazione proprietaria dell'applicazione.

Esempio:

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

app_id
string<uuid>
obbligatorio

UUID dell'applicazione di cui vuoi leggere le credenziali.

Esempio:

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

Risposta

Record dell'applicazione comprensivo di client_id e api_key.

Record completo dell'applicazione. uuid, client_id e api_key non cambiano mai dopo la creazione. Nemmeno data_location cambia, tranne una volta sull'applicazione di produzione creata con la tua organizzazione, prima che venga utilizzata (vedi la richiesta di aggiornamento).

uuid
string<uuid>

UUID dell'applicazione. Da utilizzare come {app_id} nelle chiamate successive.

Esempio:

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

name
string

Nome visualizzato dell'applicazione mostrato nella console Didit.

Esempio:

"Acme Production App"

client_id
string

Identificatore client pubblico, sicuro da incorporare nei flussi di tipo OAuth.

Esempio:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Segreto a lunga durata (chiamato anche client_secret). Da usare come intestazione x-api-key per ogni chiamata a https://verification.didit.me/v3/... (sessioni, workflow, AML, ecc.). Trattalo come una credenziale; non esporlo mai lato client. Le nuove chiavi iniziano con sk_live_ (applicazione di produzione) o sk_test_ (applicazione sandbox), seguiti da 43 caratteri URL-safe (lettere, cifre, - e _). Le chiavi create prima di questo formato non hanno prefisso e continuano a funzionare invariate. Per le 72 ore successive al recupero dell'account, le operazioni di elenco, recupero e aggiornamento restituiscono qui una stringa vuota al posto della chiave.

Esempio:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL del sito web o dell'app associato a questa applicazione.

Esempio:

"https://acme.example"

redirect_uris
string[]

URI di reindirizzamento consentiti per i flussi in stile OAuth e di reindirizzamento della verifica.

Esempio:
terms_url
string | null

URL dei termini di servizio mostrato nel flusso di verifica.

Esempio:

"https://acme.example/terms"

privacy_url
string | null

URL dell'informativa sulla privacy mostrato nel flusso di verifica.

Esempio:

"https://acme.example/privacy"

description
string | null

Descrizione interna dell'applicazione (non mostrata agli utenti finali).

created_at
string<date-time>
Esempio:

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

data_location
enum<string>

Dove vengono archiviati ed elaborati i dati di verifica dell'applicazione; questa posizione viene scelta al momento della creazione dell'applicazione. eu indica l'Unione Europea (Irlanda), il valore predefinito. au (Australia, Sydney) e mx (Messico) saranno presto disponibili: una richiesta che li specifica risponde con 400 This data location is not available yet. L'applicazione Sandbox di un'organizzazione si trova sempre nell'Unione Europea.

Opzioni disponibili:
eu,
au,
mx
Esempio:

"eu"

products
object[]
read-only

I prodotti dell'applicazione. Sempre tutti e tre, in questo ordine: identity, transactions, authentication. Una nuova applicazione ha identity abilitato con tutti i moduli attivi, e transactions e authentication disabilitati. Di sola lettura: una chiave products nel corpo di creazione o aggiornamento viene ignorata.

Esempio:
Ultima modifica il 7 novembre 2026