Vai al contenuto principale
PATCH
cURL
Usa questo endpoint per mantenere ogni applicazione allineata al cliente, al brand, all’ambiente o al caso d’uso interno che rappresenta. Per i rivenditori, questo consente di rinominare o aggiornare ogni applicazione del cliente senza condividere le credenziali tra i clienti. Per i clienti diretti, aiuta a separare prodotti, regioni o ambienti mantenendo tutto sotto un’unica organizzazione.
Questo endpoint aggiorna i metadati dell’applicazione. La api_key resta la stessa, a meno che tu non ruoti le credenziali separatamente.

Posizione dei dati

La posizione dei dati dell’applicazione (data_location) viene scelta al momento della creazione dell’applicazione e non può essere modificata in seguito: un aggiornamento che indica la posizione già assegnata all’applicazione viene accettato, mentre qualsiasi altra posizione restituisce 400. Fa eccezione l’applicazione di produzione creata insieme alla tua organizzazione, al momento della registrazione o tramite Verifica email. Il primo aggiornamento che indica un data_location sceglie la sua posizione, una sola volta, purché nessuna delle chiavi API dell’applicazione sia stata utilizzata e l’applicazione non abbia alcuna sessione di verifica. Il passaggio Dai un nome alla tua prima applicazione della console usa questa funzionalità per salvare la posizione che scegli lì. Al momento l’unica posizione disponibile è eu, l’Unione Europea (Irlanda).

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 da aggiornare.

Esempio:

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

Corpo

application/json

Invia solo i campi che desideri modificare. Semantica PATCH: i campi mancanti vengono preservati.

Corpo PATCH per i metadati dell'applicazione. Invia solo i campi che desideri modificare; i campi omessi vengono conservati. uuid, client_id e api_key non possono essere aggiornati. products è di sola lettura: una chiave products nel corpo viene ignorata. data_location non può essere modificata dopo la creazione dell'applicazione: specificare la posizione che già possiede è consentito, mentre qualsiasi altra posizione restituisce 400. L'unica eccezione è l'applicazione di produzione creata con la tua organizzazione: il primo aggiornamento che specifica una data_location la imposta, una sola volta, purché non sia stata utilizzata alcuna chiave API dell'applicazione e quest'ultima non abbia alcuna sessione di verifica.

name
string

Nome visualizzato dell'applicazione.

Esempio:

"Acme Production App"

website_url
string

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

Esempio:

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

privacy_url
string

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

description
string

Descrizione interna dell'applicazione.

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 aggiornata. La risposta è il record completo dell'applicazione dopo la modifica, inclusi i products; uuid, client_id e api_key rimangono invariati.

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