Saltar al contenido principal
Esta página es la fuente de verdad actualizada de los códigos de idioma que acepta la API de Didit. Se referencia desde las especificaciones OpenAPI, tanto para el campo language de la sesión como para el campo contact_details.email_lang de Crear sesión.

​
Dónde se aplican estos códigos

El mismo conjunto de códigos se acepta en todos los lugares donde se puede configurar un idioma: Si el idioma del navegador del usuario es compatible, la interfaz de verificación lo detecta automáticamente; si no, usa inglés (en). Si no pasas email_lang, los correos usan en. Todos los valores distinguen mayúsculas de minúsculas: usa los códigos exactos de la tabla de abajo.

​
Todos los idiomas compatibles

El conjunto de abajo refleja las claves de EMAIL_TRANSLATIONS en el servicio. Tanto la interfaz de verificación como la capa de localización de correos leen del mismo diccionario, así que cualquier código de esta tabla sirve para language y para email_lang. Tres idiomas se muestran de derecha a izquierda, tanto en la interfaz de verificación como en los correos: árabe (ar), hebreo (he) y persa / farsi (fa).
Los validadores que aceptan estos códigos son BaseSessionSerializer.validate_language y ContactDetailsSerializer.validate_email_lang. Ambos devuelven 400 con el mensaje "Invalid language. Supported languages are: ..." (o "Invalid email language...") para cualquier valor que no esté en la tabla de arriba.

​
Elegir un idioma para una sesión

La interfaz de verificación detecta automáticamente el idioma del navegador del usuario. Cuando el idioma del navegador es uno de los códigos anteriores, la interfaz y los correos se sirven en ese idioma. Si no, la interfaz usa inglés. También puedes fijar el idioma de forma explícita al crear una sesión:
Si solo defines language, los correos siguen usando inglés por defecto salvo que también pases email_lang. A la inversa, definir email_lang no cambia el idioma de la interfaz en el navegador: los dos campos son independientes.

​
Variantes por país

Tres códigos son variantes regionales que conviene preferir cuando conoces a tu audiencia:
  • pt-BR: portugués de Brasil (úsalo en lugar del genérico pt para usuarios brasileños).
  • zh-CN: chino simplificado (China continental, Singapur).
  • zh-TW: chino tradicional (Taiwán, Hong Kong, Macao).
Los códigos genéricos pt y zh también se aceptan; la variante que elijas solo afecta al vocabulario y a los caracteres, no a la lógica de verificación subyacente.

​
Solicitar un idioma nuevo

Si necesitas un idioma que no aparece arriba, contacta con nuestro equipo de soporte. Normalmente podemos añadir un idioma nuevo a EMAIL_TRANSLATIONS y a la interfaz de verificación en un plazo de 24 horas desde tu solicitud; una vez añadido, esta página se actualiza y la API acepta de inmediato el nuevo código. Contáctanos por WhatsApp o por tu canal de soporte habitual para solicitar idiomas adicionales.

​
Referencias relacionadas

API Crear sesión

Dónde se pasan language y email_lang al iniciar una verificación.

Actualizar estado de la sesión

Define email_language para el correo de notificación de cambio de estado.

Webhooks

Recibe los resultados de las verificaciones; las cargas incluyen el language elegido.

Modelos de datos

Esquema de referencia de sesiones, datos de contacto y estados.