Vai al contenuto principale

​
Trovare la tua chiave API

In Didit, le chiavi API sono limitate a una specifica Applicazione all’interno del tuo account. Un’Applicazione è uno spazio di lavoro in cui puoi configurare workflow e gestire le verifiche per un determinato progetto o ambiente. Ogni Applicazione riceve una chiave API primaria con accesso completo al momento della creazione. Puoi aggiungere altre chiavi accanto ad essa, ciascuna con il solo accesso necessario per il servizio o il partner. Per trovare le tue chiavi:
1

Accedi alla Business Console

Vai alla Didit Business Console e accedi.
2

Seleziona la tua Applicazione

Scegli l’Applicazione con cui desideri lavorare dal menu a discesa in alto.
3

Apri le chiavi API

Accedi a Developers -> API keys nella barra laterale sinistra.
4

Copia o crea una chiave

La chiave Primaria è il segreto dell’Applicazione stessa. Crea una nuova chiave per fornire a un servizio o partner un segreto dedicato, con l’accesso necessario.
La tua chiave API è un segreto: trattala come una password.La chiave primaria fornisce accesso completo all’API per conto della tua Applicazione. Non esporla mai nel codice frontend, in repository pubblici o in bundle lato client. Mantienila sempre esclusivamente lato server.

​
Formato delle chiavi API

Le nuove chiavi API iniziano con sk_live_ per un’applicazione di produzione o con sk_test_ per un’applicazione sandbox, seguiti da 43 caratteri compatibili con gli URL (lettere, cifre, - e _). Le chiavi create prima di questo formato non hanno prefisso e continuano a funzionare senza modifiche. Invia l’intera chiave, prefisso incluso, nell’intestazione x-api-key, e non rifiutare una chiave solo perché è priva di prefisso.

​
Trovare il tuo ID organizzazione

Il tuo ID organizzazione è l’UUID che identifica la tua organizzazione. Lo utilizzi nei percorsi API con ambito a livello di organizzazione come /auth/v2/organizations/me/{org_id}/applications/. Puoi copiarlo direttamente dalla Business Console, senza necessità di effettuare chiamate API:
1

Apri le impostazioni dell'organizzazione

Nella Didit Business Console, vai su Impostazioni organizzazione.
2

Copia l'ID organizzazione

Il campo ID organizzazione mostra l’UUID della tua organizzazione accanto al relativo nome, con un pulsante per copiarlo negli appunti.

​
Eseguire richieste autenticate

Per autenticare una richiesta API, includi la tua chiave API segreta nell’intestazione HTTP x-api-key. Ecco un esempio di richiesta autenticata all’endpoint Create Session:
cURL

​
Gestione degli errori

Se la tua chiave API è errata, malformata o revocata, l’API restituisce 401 Unauthorized:
Una chiave scaduta restituisce anch’essa 401, con "detail": "This API key has expired.". Una richiesta priva di chiave restituisce 403 con "detail": "You do not have permission to perform this action.". La pagina sugli errori API elenca ogni stato, corpo e codice.

​
Chiavi API con ambito limitato

Assegna a ciascun servizio o partner una chiave dedicata invece di condividere quella primaria. Ciascuna chiave ha il proprio accesso: nessuno, lettura o scrittura per ogni risorsa (sessioni, decisioni, media, persone, aziende, transazioni, workflow, webhook, impostazioni dell’applicazione, analisi), oltre a limitazioni facoltative per alcuni workflow, per le sole sessioni approvate e per un elenco di indirizzi IP, nonché a una data di scadenza. Puoi ruotare una chiave con una sovrapposizione di 24 ore e revocarla immediatamente. Le chiavi create prima dell’introduzione dell’accesso con ambito limitato mantengono l’accesso completo. Consulta Chiavi API per i preset, le risorse coperte da ciascuno di essi e il modo in cui l’API risponde quando viene utilizzata una chiave con ambito limitato.
Se ricevi un errore 401, verifica di utilizzare la chiave API corretta per l’Applicazione giusta e che non sia stata rigenerata.
Ultima modifica il 7 novembre 2026