Vai al contenuto principale
Questa pagina è la fonte di riferimento sempre aggiornata per i codici lingua accettati dall’API Didit. Le specifiche OpenAPI la citano sia per il campo language a livello di sessione sia per il campo contact_details.email_lang in Crea sessione.

​
Dove si applicano questi codici

Lo stesso insieme di codici è accettato ovunque sia configurabile una lingua: Se la lingua del browser dell’utente è supportata, l’interfaccia di verifica la rileva automaticamente; altrimenti ricorre all’inglese (en). Se non passi email_lang, le email usano en come predefinita. Tutti i valori distinguono tra maiuscole e minuscole: usa i codici esatti della tabella seguente.

​
Tutte le lingue supportate

L’insieme seguente riflette le chiavi di EMAIL_TRANSLATIONS nel servizio: sia il livello dell’interfaccia di verifica sia quello di localizzazione delle email leggono dallo stesso dizionario, quindi ogni codice in questa tabella funziona sia per language sia per email_lang. Tre lingue vengono visualizzate da destra a sinistra sia nell’interfaccia di verifica sia nelle email: arabo (ar), ebraico (he) e persiano / farsi (fa).
I validatori che accettano questi codici sono BaseSessionSerializer.validate_language e ContactDetailsSerializer.validate_email_lang. Entrambi restituiscono 400 con il messaggio "Invalid language. Supported languages are: ..." (oppure "Invalid email language...") per qualsiasi valore non presente nella tabella sopra.

​
Scegliere una lingua per una sessione

L’interfaccia di verifica rileva automaticamente la lingua del browser dell’utente. Quando la lingua del browser è uno dei codici sopra, l’interfaccia e le email vengono visualizzate in quella lingua. In caso contrario, l’interfaccia ricorre all’inglese. Puoi anche impostare la lingua in modo esplicito quando crei una sessione:
Se imposti solo language, le email restano in inglese a meno che tu non passi anche email_lang. Viceversa, impostare email_lang non cambia la lingua dell’interfaccia nel browser: i due campi sono indipendenti.

​
Varianti per paese

Tre codici sono varianti regionali che conviene preferire quando conosci il tuo pubblico:
  • pt-BR: portoghese brasiliano (usalo al posto del generico pt per gli utenti brasiliani).
  • zh-CN: cinese semplificato (Cina continentale, Singapore).
  • zh-TW: cinese tradizionale (Taiwan, Hong Kong, Macao).
I codici generici pt e zh sono accettati anche; la variante che scegli influisce solo sul lessico e sui caratteri, non sulla logica di verifica sottostante.

​
Richiedere una nuova lingua

Se ti serve una lingua non elencata sopra, contatta il nostro team di supporto. Di solito possiamo aggiungere una nuova lingua a EMAIL_TRANSLATIONS e all’interfaccia di verifica entro 24 ore dalla richiesta. Una volta aggiunta, questa pagina viene aggiornata e il nuovo codice viene subito accettato dall’API. Scrivici a hello@didit.me o tramite il tuo solito canale di supporto per richiedere il supporto a lingue aggiuntive.

​
Riferimenti correlati

API per la creazione della sessione

Indica dove vengono passati language e email_lang all’avvio di una verifica.

Aggiorna lo stato della sessione

Imposta email_language per l’email di notifica della modifica di stato.

Webhooks

Ricevi i risultati delle verifiche: i payload includono la lingua selezionata, inclusa nel campo language.

Modelli di dati

Schema canonico per sessioni, dati di contatto e stati.
Ultima modifica il 7 novembre 2026