> ## 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 は確認UIとメール通知で54言語に対応。ブラウザの言語を自動検出し、受け付ける言語コードを1か所で一覧できます。

このページは、Didit API が受け付ける言語コードの **最新の正式な情報源** です。OpenAPI 仕様からは、セッションレベルの `language` フィールドと、[セッションの作成](https://docs.didit.me/sessions-api/create-session.md) の `contact_details.email_lang` フィールドの両方で参照されています。

## これらのコードが使われる場所

言語を設定できるすべての場所で、同じコードのセットが受け付けられます。

| フィールド | 場所 | 制御する内容 |
| - | - | - |
| `language` | `POST /v3/session/` のボディ | エンドユーザーに表示される **確認UI** の言語です。 |
| `contact_details.email_lang` | `POST /v3/session/` のボディ | **メール通知** (招待、リマインダー、ステータス更新) の言語です。 |
| `email_language` | `PATCH /v3/session/{id}/update-status/` のボディ | `send_email=true` のときの、ステータス変更メールの言語です。 |

ユーザーのブラウザのロケールが対応している場合、確認UIはそれを自動検出します。対応していない場合は **英語** (`en`) にフォールバックします。`email_lang` を渡さない場合、メールは `en` にフォールバックします。すべての値は大文字と小文字を区別します。下の表のコードをそのまま使用してください。

## 対応言語の一覧

以下のセットは、サービス内の `EMAIL_TRANSLATIONS` のキーと一致しています。確認UIとメールのローカライズ層は同じ辞書を読み込むため、この表のどのコードも `language` と `email_lang` の両方で使えます。

| # | 言語 | 現地での名称 | コード | 方向 |
| - | - | - | - | - |
| 1 | アルバニア語 | Shqip | `sq` | LTR |
| 2 | アラビア語 | العربية | `ar` | **RTL** |
| 3 | アルメニア語 | Հայերեն | `hy` | LTR |
| 4 | ベンガル語 | বাংলা | `bn` | LTR |
| 5 | ボスニア語 | Bosanski | `bs` | LTR |
| 6 | ブルガリア語 | Български | `bg` | LTR |
| 7 | カタルーニャ語 | Català | `ca` | LTR |
| 8 | 中国語 (汎用) | 中文 | `zh` | LTR |
| 9 | 中国語 (簡体字) | 简体中文 | `zh-CN` | LTR |
| 10 | 中国語 (繁体字) | 繁體中文 | `zh-TW` | LTR |
| 11 | クロアチア語 | Hrvatski | `hr` | LTR |
| 12 | チェコ語 | Čeština | `cs` | LTR |
| 13 | デンマーク語 | Dansk | `da` | LTR |
| 14 | オランダ語 | Nederlands | `nl` | LTR |
| 15 | 英語 | English | `en` | LTR |
| 16 | エストニア語 | Eesti | `et` | LTR |
| 17 | フィンランド語 | Suomi | `fi` | LTR |
| 18 | フランス語 | Français | `fr` | LTR |
| 19 | ジョージア語 | ქართული | `ka` | LTR |
| 20 | ドイツ語 | Deutsch | `de` | LTR |
| 21 | ギリシャ語 | Ελληνικά | `el` | LTR |
| 22 | ヘブライ語 | עברית | `he` | **RTL** |
| 23 | ヒンディー語 | हिन्दी | `hi` | LTR |
| 24 | ハンガリー語 | Magyar | `hu` | LTR |
| 25 | インドネシア語 | Bahasa Indonesia | `id` | LTR |
| 26 | イタリア語 | Italiano | `it` | LTR |
| 27 | 日本語 | 日本語 | `ja` | LTR |
| 28 | カザフ語 | Қазақ тілі | `kk` | LTR |
| 29 | 韓国語 | 한국어 | `ko` | LTR |
| 30 | キルギス語 | Кыргызча | `ky` | LTR |
| 31 | ラトビア語 | Latviešu | `lv` | LTR |
| 32 | リトアニア語 | Lietuvių | `lt` | LTR |
| 33 | マケドニア語 | Македонски | `mk` | LTR |
| 34 | マレー語 | Bahasa Melayu | `ms` | LTR |
| 35 | モンゴル語 | Монгол | `mn` | LTR |
| 36 | モンテネグロ語 | Crnogorski | `cnr` | LTR |
| 37 | ノルウェー語 | Norsk | `no` | LTR |
| 38 | ペルシア語 (ファルシー) | فارسی | `fa` | **RTL** |
| 39 | ポーランド語 | Polski | `pl` | LTR |
| 40 | ポルトガル語 | Português | `pt` | LTR |
| 41 | ポルトガル語 (ブラジル) | Português (Brasil) | `pt-BR` | LTR |
| 42 | ルーマニア語 | Română | `ro` | LTR |
| 43 | ロシア語 | Русский | `ru` | LTR |
| 44 | セルビア語 | Српски / Srpski | `sr` | LTR |
| 45 | スロバキア語 | Slovenčina | `sk` | LTR |
| 46 | スロベニア語 | Slovenščina | `sl` | LTR |
| 47 | ソマリ語 | Soomaali | `so` | LTR |
| 48 | スペイン語 | Español | `es` | LTR |
| 49 | スウェーデン語 | Svenska | `sv` | LTR |
| 50 | タイ語 | ไทย | `th` | LTR |
| 51 | トルコ語 | Türkçe | `tr` | LTR |
| 52 | ウクライナ語 | Українська | `uk` | LTR |
| 53 | ウズベク語 | Oʻzbekcha | `uz` | LTR |
| 54 | ベトナム語 | Tiếng Việt | `vi` | LTR |

右から左に表示される言語は3つあり、確認UIとメールの両方で右から左に描画されます。**アラビア語** (`ar`)、**ヘブライ語** (`he`)、**ペルシア語 / ファルシー** (`fa`) です。

> [!TIP]
>
> これらのコードを受け付けるバリデーターは `BaseSessionSerializer.validate_language` と `ContactDetailsSerializer.validate_email_lang` です。どちらも、上の表にない値に対して、メッセージ `"Invalid language. Supported languages are: ..."` (または `"Invalid email language..."`) とともに `400` を返します。

## セッションの言語を選ぶ

確認UIは、ユーザーのブラウザの言語を **自動検出** します。ブラウザの言語が上記のコードのいずれかである場合、画面とメールはその言語で表示されます。そうでない場合、UI は **英語** にフォールバックします。

セッションの作成時に、言語を明示的に設定することもできます。

```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` を設定しても、ブラウザ上の UI の言語は変わりません。この2つのフィールドは独立しています。

## 地域別のバリアント

3つのコードは **地域別のバリアント** で、対象の利用者がわかっている場合はこちらを優先してください。

* `pt-BR` - ブラジルのポルトガル語 (ブラジルのユーザーには、汎用の `pt` ではなくこちらを使用します)。
* `zh-CN` - 簡体字中国語 (中国本土、シンガポール)。
* `zh-TW` - 繁体字中国語 (台湾、香港、マカオ)。

汎用のコード `pt` と `zh` も受け付けられます。どのバリアントを選んでも、変わるのは語彙と文字だけで、基盤となる確認ロジックには影響しません。

## 新しい言語をリクエストする

上記にない言語が必要な場合は、サポートチームにご連絡ください。通常、リクエストから **24時間以内** に、`EMAIL_TRANSLATIONS` と確認UIに新しい言語を追加できます。追加後はこのページが更新され、新しいコードがすぐに API で受け付けられます。

言語の追加をリクエストするには、[WhatsApp](https://wa.me/+19544659728) または通常のサポート窓口からご連絡ください。

## 関連リファレンス

> **[セッション作成API](https://docs.didit.me/sessions-api/create-session.md)**
>
> 確認を開始するときに `language` と `email_lang` を渡す場所です。

> **[セッションステータスの更新](https://docs.didit.me/sessions-api/update-status.md)**
>
> ステータス変更通知メールの `email_language` を設定します。

> **[Webhook](https://docs.didit.me/integration/webhooks.md)**
>
> 確認結果を受け取ります。ペイロードには選択された `language` が含まれます。

> **[データモデル](https://docs.didit.me/reference/data-models.md)**
>
> セッション、連絡先情報、ステータスの正式なスキーマです。


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