> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 支持的 54 种语言：多语言 KYC

> Didit 支持 54 种语言，用于验证界面和邮件通知，支持浏览器自动检测，并作为可接受语言代码的唯一可信来源，统一管理语言代码。

本页面是 Didit API 所接受语言代码的**权威实时来源**。[创建会话](https://docs.didit.me/zh/sessions-api/create-session.md) 的 OpenAPI 规范中，会话级 `language` 字段和 `contact_details.email_lang` 字段都引用了本页面。

## 这些代码的适用范围

同一组代码适用于所有可配置语言的地方：

| 字段 | 位置 | 控制内容 |
| - | - | - |
| `language` | `POST /v3/session/` 请求体 | 显示给终端用户的**验证界面**语言。 |
| `contact_details.email_lang` | `POST /v3/session/` 请求体 | **邮件通知**的语言（邀请、提醒、状态更新）。 |
| `email_language` | `PATCH /v3/session/{id}/update-status/` 请求体 | 当 `send_email=true` 时，状态变更邮件的语言。 |

如果用户的浏览器区域设置受支持，验证界面会自动识别并使用该语言；否则回退为**英语**（`en`）。如果您未传递 `email_lang`，邮件将回退为 `en`。所有值都区分大小写，请使用下表中的准确代码。

## 所有支持的语言

下表与服务中 `EMAIL_TRANSLATIONS` 的键保持一致。验证界面和邮件本地化层都从同一字典读取，因此本表中的任何代码都可同时用于 `language` 和 `email_lang`。

| # | 语言 | 母语名称 | 代码 | 排版方向 |
| - | - | - | - | - |
| 1 | 阿尔巴尼亚语 | Shqip | `sq` | 从左到右 |
| 2 | 阿拉伯语 | العربية | `ar` | **从右到左** |
| 3 | 亚美尼亚语 | Հայերեն | `hy` | 从左到右 |
| 4 | 孟加拉语 | বাংলা | `bn` | 从左到右 |
| 5 | 波斯尼亚语 | Bosanski | `bs` | 从左到右 |
| 6 | 保加利亚语 | Български | `bg` | 从左到右 |
| 7 | 加泰罗尼亚语 | Català | `ca` | 从左到右 |
| 8 | 中文（通用） | 中文 | `zh` | 从左到右 |
| 9 | 中文（简体） | 简体中文 | `zh-CN` | 从左到右 |
| 10 | 中文（繁体） | 繁體中文 | `zh-TW` | 从左到右 |
| 11 | 克罗地亚语 | Hrvatski | `hr` | 从左到右 |
| 12 | 捷克语 | Čeština | `cs` | 从左到右 |
| 13 | 丹麦语 | Dansk | `da` | 从左到右 |
| 14 | 荷兰语 | Nederlands | `nl` | 从左到右 |
| 15 | 英语 | English | `en` | 从左到右 |
| 16 | 爱沙尼亚语 | Eesti | `et` | 从左到右 |
| 17 | 芬兰语 | Suomi | `fi` | 从左到右 |
| 18 | 法语 | Français | `fr` | 从左到右 |
| 19 | 格鲁吉亚语 | ქართული | `ka` | 从左到右 |
| 20 | 德语 | Deutsch | `de` | 从左到右 |
| 21 | 希腊语 | Ελληνικά | `el` | 从左到右 |
| 22 | 希伯来语 | עברית | `he` | **从右到左** |
| 23 | 印地语 | हिन्दी | `hi` | 从左到右 |
| 24 | 匈牙利语 | Magyar | `hu` | 从左到右 |
| 25 | 印度尼西亚语 | Bahasa Indonesia | `id` | 从左到右 |
| 26 | 意大利语 | Italiano | `it` | 从左到右 |
| 27 | 日语 | 日本語 | `ja` | 从左到右 |
| 28 | 哈萨克语 | Қазақ тілі | `kk` | 从左到右 |
| 29 | 韩语 | 한국어 | `ko` | 从左到右 |
| 30 | 吉尔吉斯语 | Кыргызча | `ky` | 从左到右 |
| 31 | 拉脱维亚语 | Latviešu | `lv` | 从左到右 |
| 32 | 立陶宛语 | Lietuvių | `lt` | 从左到右 |
| 33 | 马其顿语 | Македонски | `mk` | 从左到右 |
| 34 | 马来语 | Bahasa Melayu | `ms` | 从左到右 |
| 35 | 蒙古语 | Монгол | `mn` | 从左到右 |
| 36 | 黑山语 | Crnogorski | `cnr` | 从左到右 |
| 37 | 挪威语 | Norsk | `no` | 从左到右 |
| 38 | 波斯语（法尔西语） | فارسی | `fa` | **从右到左** |
| 39 | 波兰语 | Polski | `pl` | 从左到右 |
| 40 | 葡萄牙语 | Português | `pt` | 从左到右 |
| 41 | 葡萄牙语（巴西） | Português (Brasil) | `pt-BR` | 从左到右 |
| 42 | 罗马尼亚语 | Română | `ro` | 从左到右 |
| 43 | 俄语 | Русский | `ru` | 从左到右 |
| 44 | 塞尔维亚语 | Српски / Srpski | `sr` | 从左到右 |
| 45 | 斯洛伐克语 | Slovenčina | `sk` | 从左到右 |
| 46 | 斯洛文尼亚语 | Slovenščina | `sl` | 从左到右 |
| 47 | 索马里语 | Soomaali | `so` | 从左到右 |
| 48 | 西班牙语 | Español | `es` | 从左到右 |
| 49 | 瑞典语 | Svenska | `sv` | 从左到右 |
| 50 | 泰语 | ไทย | `th` | 从左到右 |
| 51 | 土耳其语 | Türkçe | `tr` | 从左到右 |
| 52 | 乌克兰语 | Українська | `uk` | 从左到右 |
| 53 | 乌兹别克语 | Oʻzbekcha | `uz` | 从左到右 |
| 54 | 越南语 | Tiếng Việt | `vi` | 从左到右 |

以下三种语言在验证界面和邮件中都从右到左排版：**阿拉伯语**（`ar`）、**希伯来语**（`he`）和**波斯语（法尔西语）**（`fa`）。

> [!TIP]
>
> 接受这些代码的验证器是 `BaseSessionSerializer.validate_language` 和 `ContactDetailsSerializer.validate_email_lang`。对于超出上表范围的任何值，两者都会以 `400` 状态码报错，并返回消息 `"Invalid language. Supported languages are: ..."`（或 `"Invalid email language..."`）。

## 为会话选择语言

验证界面会**自动检测**用户的浏览器语言。当浏览器语言是上述代码之一时，界面和邮件都将以该语言显示。否则界面将回退为**英语**。

您也可以在创建会话时明确设置语言：

```json theme={null}
{
  "workflow_id": "your-workflow-id",
  "language": "es",
  "contact_details": {
    "email": "user@example.com",
    "send_notification_emails": true,
    "email_lang": "es"
  }
}
```

如果您只设置 `language`，除非同时传递 `email_lang`，邮件仍默认为英语。反之，设置 `email_lang` 不会改变浏览器中的界面语言，这两个字段相互独立。

## 国家和地区变体

当您清楚受众所在的地区时，建议优先使用以下三个**地区变体**代码：

* `pt-BR`：巴西葡萄牙语（面向巴西用户时，请使用此代码而非通用的 `pt`）。
* `zh-CN`：简体中文（中国大陆、新加坡）。
* `zh-TW`：繁体中文（台湾、香港、澳门）。

通用代码 `pt` 和 `zh` 同样可以接受。您选择的变体只影响用词和字符，不影响底层的验证逻辑。

## 申请新增语言

如果您需要的语言不在上述列表中，请联系我们的支持团队。通常我们可以在收到您的请求后 **24 小时内**，为 `EMAIL_TRANSLATIONS` 和验证界面新增该语言。新语言添加后，本页面会随之更新，API 将立即接受新代码。

如需申请新增语言支持，请通过 [hello@didit.me](mailto:hello@didit.me) 联系我们，或通过您平时使用的支持渠道联系。

## 相关参考

> [card] [创建会话 API](https://docs.didit.me/zh/sessions-api/create-session.md)
>
> 介绍发起验证时如何传递 `language` 和 `email_lang` 参数。

> [card] [更新会话状态](https://docs.didit.me/zh/sessions-api/update-status.md)
>
> 为状态变更通知邮件设置 `email_language`。

> [card] [Webhook](https://docs.didit.me/zh/integration/webhooks.md)
>
> 接收验证结果，payload 中包含所选的 `language`。

> [card] [数据模型](https://docs.didit.me/zh/reference/data-models.md)
>
> 会话、联系方式和状态的标准数据结构。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.