language 字段和 contact_details.email_lang 字段都引用了本页面。
这些代码的适用范围
同一组代码适用于所有可配置语言的地方:
如果用户的浏览器区域设置受支持,验证界面会自动识别并使用该语言;否则回退为英语(
en)。如果您未传递 email_lang,邮件将回退为 en。所有值都区分大小写,请使用下表中的准确代码。
所有支持的语言
下表与服务中EMAIL_TRANSLATIONS 的键保持一致。验证界面和邮件本地化层都从同一字典读取,因此本表中的任何代码都可同时用于 language 和 email_lang。
以下三种语言在验证界面和邮件中都从右到左排版:阿拉伯语(
ar)、希伯来语(he)和波斯语(法尔西语)(fa)。
为会话选择语言
验证界面会自动检测用户的浏览器语言。当浏览器语言是上述代码之一时,界面和邮件都将以该语言显示。否则界面将回退为英语。 您也可以在创建会话时明确设置语言: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。数据模型
会话、联系方式和状态的标准数据结构。