跳转到主要内容
本页面是 Didit API 所接受语言代码的权威实时来源。创建会话 的 OpenAPI 规范中,会话级 language 字段和 contact_details.email_lang 字段都引用了本页面。

这些代码的适用范围

同一组代码适用于所有可配置语言的地方: 如果用户的浏览器区域设置受支持,验证界面会自动识别并使用该语言;否则回退为英语(en)。如果您未传递 email_lang,邮件将回退为 en。所有值都区分大小写,请使用下表中的准确代码。

所有支持的语言

下表与服务中 EMAIL_TRANSLATIONS 的键保持一致。验证界面和邮件本地化层都从同一字典读取,因此本表中的任何代码都可同时用于 language 和 email_lang。 以下三种语言在验证界面和邮件中都从右到左排版:阿拉伯语(ar)、希伯来语(he)和波斯语(法尔西语)(fa)。
接受这些代码的验证器是 BaseSessionSerializer.validate_language 和 ContactDetailsSerializer.validate_email_lang。对于超出上表范围的任何值,两者都会以 400 状态码报错,并返回消息 "Invalid language. Supported languages are: ..."(或 "Invalid email language...")。

为会话选择语言

验证界面会自动检测用户的浏览器语言。当浏览器语言是上述代码之一时,界面和邮件都将以该语言显示。否则界面将回退为英语。 您也可以在创建会话时明确设置语言:
如果您只设置 language,除非同时传递 email_lang,邮件仍默认为英语。反之,设置 email_lang 不会改变浏览器中的界面语言,这两个字段相互独立。

国家和地区变体

当您清楚受众所在的地区时,建议优先使用以下三个地区变体代码:
  • pt-BR:巴西葡萄牙语(面向巴西用户时,请使用此代码而非通用的 pt)。
  • zh-CN:简体中文(中国大陆、新加坡)。
  • zh-TW:繁体中文(台湾、香港、澳门)。
通用代码 pt 和 zh 同样可以接受。您选择的变体只影响用词和字符,不影响底层的验证逻辑。

申请新增语言

如果您需要的语言不在上述列表中,请联系我们的支持团队。通常我们可以在收到您的请求后 24 小时内,为 EMAIL_TRANSLATIONS 和验证界面新增该语言。新语言添加后,本页面会随之更新,API 将立即接受新代码。 如需申请新增语言支持,请通过 hello@didit.me 联系我们,或通过您平时使用的支持渠道联系。

相关参考

创建会话 API

介绍发起验证时如何传递 language 和 email_lang 参数。

更新会话状态

为状态变更通知邮件设置 email_language。

Webhook

接收验证结果,payload 中包含所选的 language。

数据模型

会话、联系方式和状态的标准数据结构。
最后修改于 2026年11月7日