Saltar al contingut principal
Aquesta pàgina és la font de veritat en temps real dels codis d’idioma que accepta l’API de Didit. Les especificacions d’OpenAPI la referencien per als camps de nivell de sessió language i contact_details.email_lang de Create Session.

​
On s’apliquen aquests codis

El mateix conjunt de codis s’accepta a tots els llocs on es pot configurar un idioma: Si la configuració regional del navegador de l’usuari és compatible, la interfície de verificació la detecta automàticament; si no ho és, utilitza l’anglès (en) per defecte. Si no passes email_lang, els correus electrònics utilitzen en. Tots els valors distingeixen entre majúscules i minúscules: fes servir els codis exactes de la taula següent.

​
Tots els idiomes admesos

El conjunt següent reflecteix les claus de EMAIL_TRANSLATIONS al servei: tant la interfície de verificació com la capa de localització de correus electrònics llegeixen del mateix diccionari, de manera que qualsevol codi d’aquesta taula funciona tant per a language com per a email_lang. Tres idiomes es mostren de dreta a esquerra tant a la interfície de verificació com als correus electrònics: àrab (ar), hebreu (he) i persa / farsi (fa).
Els validadors que accepten aquests codis són BaseSessionSerializer.validate_language i ContactDetailsSerializer.validate_email_lang. Tots dos generen un error 400 amb el missatge "Invalid language. Supported languages are: ..." (o "Invalid email language...") per a qualsevol valor que no sigui a la taula anterior.

​
Com triar un idioma per a una sessió

La interfície de verificació detecta automàticament l’idioma del navegador de l’usuari. Quan l’idioma del navegador és un dels codis anteriors, la interfície i els correus electrònics es mostren en aquest idioma. Si no, la interfície utilitza l’anglès per defecte. També pots definir l’idioma explícitament en crear una sessió:
Si només defineixes language, els correus electrònics continuaran utilitzant l’anglès per defecte, tret que també passis email_lang. A la inversa, definir email_lang no canvia l’idioma de la interfície al navegador: els dos camps són independents.

​
Variants per país

Hi ha tres codis que són variants regionals i que has de preferir quan coneguis el teu públic:
  • pt-BR: portuguès brasiler (usa’l en lloc de pt genèric per als usuaris del Brasil).
  • zh-CN: xinès simplificat (Xina continental, Singapur).
  • zh-TW: xinès tradicional (Taiwan, Hong Kong, Macau).
També s’accepten els codis genèrics pt i zh; la variant que triis només afecta el vocabulari i els caràcters, no la lògica de verificació subjacent.

​
Com sol·licitar un idioma nou

Si necessites un idioma que no figura a la llista anterior, contacta amb el nostre equip de suport. Normalment podem afegir un idioma nou a EMAIL_TRANSLATIONS i a la interfície de verificació en un termini de 24 hores des de la teva sol·licitud. Un cop afegit, aquesta pàgina s’actualitza i l’API accepta el codi nou immediatament. Contacta amb nosaltres a hello@didit.me o a través del teu canal de suport habitual per sol·licitar suport per a idiomes addicionals.

​
Referències relacionades

API per crear sessions

On es passen language i email_lang en iniciar una verificació.

Actualitzar l'estat de la sessió

Defineix email_language per al correu de notificació del canvi d’estat.

Webhooks

Rep els resultats de la verificació: els payloads inclouen el language escollit.

Models de dades

Esquema canònic de sessions, dades de contacte i estats.
Darrera modificació el 7 de novembre del 2026