Saltar para o conteúdo principal
Esta página é a fonte de referência em tempo real para os códigos de idioma aceites pela API da Didit. Está referenciada nas especificações OpenAPI, tanto para o campo language ao nível da sessão como para o campo contact_details.email_lang em Criar sessão.

​
Onde se aplicam estes códigos

O mesmo conjunto de códigos é aceite em todos os locais onde é possível configurar um idioma: Se o idioma do navegador do utilizador for suportado, a interface de verificação deteta-o automaticamente; caso contrário, recorre ao Inglês (en). Se não indicar email_lang, os e-mails usam en. Todos os valores são sensíveis a maiúsculas e minúsculas. Utilize os códigos exatos indicados na tabela abaixo.

​
Todos os idiomas suportados

O conjunto abaixo reflete as chaves de EMAIL_TRANSLATIONS no serviço. A interface de verificação e a camada de localização de e-mails leem do mesmo dicionário, pelo que qualquer código desta tabela funciona tanto para language como para email_lang. Três idiomas são apresentados da direita para a esquerda, tanto na interface de verificação como nos e-mails: Árabe (ar), Hebraico (he) e Persa / Farsi (fa).
Os validadores que aceitam estes códigos são BaseSessionSerializer.validate_language e ContactDetailsSerializer.validate_email_lang. Ambos devolvem 400 com a mensagem "Invalid language. Supported languages are: ..." (ou "Invalid email language...") para qualquer valor fora da tabela acima.

​
Escolher um idioma para uma sessão

A interface de verificação deteta automaticamente o idioma do navegador do utilizador. Quando o idioma do navegador é um dos códigos acima, a interface e os e-mails são apresentados nesse idioma. Caso contrário, a interface recorre ao Inglês. Também pode definir o idioma explicitamente ao criar uma sessão:
Se definir apenas language, os e-mails continuam em Inglês, a menos que indique também email_lang. Inversamente, definir email_lang não altera o idioma da interface no navegador: os dois campos são independentes.

​
Variantes por país

Três códigos são variantes regionais que deve preferir quando conhece o seu público:
  • pt-BR: Português do Brasil (use em vez de pt genérico para utilizadores brasileiros).
  • zh-CN: Chinês simplificado (China continental, Singapura).
  • zh-TW: Chinês tradicional (Taiwan, Hong Kong, Macau).
Os códigos genéricos pt e zh também são aceites. A variante que escolher afeta apenas o vocabulário e os caracteres, não a lógica de verificação subjacente.

​
Pedir um novo idioma

Se precisar de um idioma que não esteja indicado acima, contacte a nossa equipa de suporte. Normalmente, conseguimos adicionar um novo idioma a EMAIL_TRANSLATIONS e à interface de verificação no prazo de 24 horas após o seu pedido. Depois de adicionado, esta página é atualizada e o novo código passa a ser aceite de imediato pela API. Contacte-nos em hello@didit.me ou através do seu canal de suporte habitual para pedir suporte a idiomas adicionais.

​
Referências relacionadas

API de criação de sessão

Onde language e email_lang são enviados ao iniciar uma verificação.

Atualizar estado da sessão

Define email_language para o e-mail de notificação da alteração de estado.

Webhooks

Receba os resultados da verificação, já que os payloads incluem o language escolhido.

Modelos de dados

Esquema canónico para sessões, dados de contacto e estados.
Última modificação em 7 de novembro de 2026