Vai al contenuto principale
POST
cURL
Usa questo endpoint quando devi separare il traffico di verifica, le credenziali, il branding o la reportistica all’interno della stessa organizzazione. Questo è particolarmente utile per i rivenditori che creano un’applicazione per ogni cliente. Funziona bene anche quando la tua azienda ha più prodotti, brand, regioni, ambienti di staging/produzione o casi d’uso che non devono condividere la stessa chiave API e le stesse impostazioni a livello di applicazione.
Tutti gli endpoint di Auth API usano https://apx.didit.me/auth/v2. Usa l’api_key restituita come x-api-key quando chiami gli endpoint https://verification.didit.me/v3/..., come sessioni e workflow.

Ubicazione dei dati

Ogni applicazione archivia ed elabora i dati di verifica in un’unica ubicazione, ovvero la sua ubicazione dei dati, scelta al momento della creazione tramite data_location. Oggi l’unica ubicazione disponibile è eu, l’Unione Europea (Irlanda), che è anche il valore predefinito se ometti il campo. Australia (Sydney, au) e Messico (mx) sono in arrivo: una richiesta che li indica risponde con 400 This data location is not available yet. e non crea nulla. Ogni lettura dei dati dell’applicazione restituisce il relativo data_location, che non può essere modificato dopo la creazione dell’applicazione. Vedi Ubicazione dei dati.

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. Cercalo con GET /organizations/me/.

Esempio:

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

Corpo

application/json

Tutti i campi sono facoltativi. L'omissione del body crea un'applicazione con il nome predefinito "<organization name> App" e nessun URL pubblico configurato.

Tutti i campi sono facoltativi. L'invio di un body vuoto crea un'applicazione con un nome predefinito, nell'Unione Europea.

name
string

Nome visualizzato dell'applicazione. Il valore predefinito è "<organization name> App".

Esempio:

"Acme Customer App"

website_url
string

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

URL dei termini di servizio mostrato nel flusso di verifica.

Esempio:

"https://acme.example/terms"

privacy_url
string

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

Esempio:

"https://acme.example/privacy"

description
string

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

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"

Risposta

Applicazione creata. La risposta include la api_key a lungo termine; salvala ora e usala come intestazione x-api-key in ogni chiamata https://verification.didit.me/v3/....

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