Passer au contenu principal
Cette page est la source de référence en temps réel pour les codes de langue acceptés par l’API Didit. Elle est citée dans les spécifications OpenAPI, à la fois pour le champ language au niveau de la session et pour le champ contact_details.email_lang de Créer une session.

​
Où ces codes s’appliquent

Le même ensemble de codes est accepté partout où une langue peut être configurée : Si les paramètres régionaux du navigateur de l’utilisateur sont pris en charge, l’interface de vérification les détecte automatiquement ; sinon, elle utilise l’anglais (en) par défaut. Si vous ne transmettez pas email_lang, les e-mails utilisent en par défaut. Toutes les valeurs sont sensibles à la casse : utilisez les codes exacts du tableau ci-dessous.

​
Toutes les langues prises en charge

L’ensemble ci-dessous reprend les clés de EMAIL_TRANSLATIONS du service. L’interface de vérification et la couche de localisation des e-mails lisent le même dictionnaire, donc tout code de ce tableau fonctionne aussi bien pour language que pour email_lang. Trois langues s’affichent de droite à gauche, dans l’interface de vérification comme dans les e-mails : l’arabe (ar), l’hébreu (he) et le persan / farsi (fa).
Les validateurs qui acceptent ces codes sont BaseSessionSerializer.validate_language et ContactDetailsSerializer.validate_email_lang. Pour toute valeur absente du tableau ci-dessus, ils renvoient une erreur 400 avec le message "Invalid language. Supported languages are: ..." (ou "Invalid email language...").

​
Choisir une langue pour une session

L’interface de vérification détecte automatiquement la langue du navigateur de l’utilisateur. Lorsque cette langue figure parmi les codes ci-dessus, l’interface et les e-mails sont servis dans cette langue. Sinon, l’interface utilise l’anglais par défaut. Vous pouvez aussi définir la langue explicitement lors de la création d’une session :
Si vous ne définissez que language, les e-mails restent en anglais, sauf si vous transmettez également email_lang. Inversement, définir email_lang ne modifie pas la langue de l’interface dans le navigateur : les deux champs sont indépendants.

​
Variantes par pays

Trois codes sont des variantes régionales à privilégier lorsque vous connaissez votre public :
  • pt-BR : portugais brésilien (à utiliser à la place de pt générique pour les utilisateurs brésiliens).
  • zh-CN : chinois simplifié (Chine continentale, Singapour).
  • zh-TW : chinois traditionnel (Taïwan, Hong Kong, Macao).
Les codes génériques pt et zh sont également acceptés. La variante choisie n’affecte que le vocabulaire et les caractères, et non la logique de vérification sous-jacente.

​
Demander une nouvelle langue

Si vous avez besoin d’une langue absente de cette liste, contactez notre équipe support. Nous pouvons généralement ajouter une nouvelle langue à EMAIL_TRANSLATIONS et à l’interface de vérification dans les 24 heures suivant votre demande. Une fois ajoutée, cette page est mise à jour et le nouveau code est immédiatement accepté par l’API. Contactez-nous à hello@didit.me ou via votre canal de support habituel pour demander la prise en charge d’une langue supplémentaire.

​
Références associées

API de création de session

Indique où language et email_lang sont transmis au lancement d’une vérification.

Mise à jour du statut de session

Définit email_language pour l’e-mail de notification envoyé lors du changement de statut.

Webhooks

Recevez les résultats de vérification : les payloads contiennent la langue choisie dans language.

Modèles de données

Schéma canonique des sessions, des coordonnées et des statuts.
Dernière modification le 7 novembre 2026