メインコンテンツへスキップ
このページは、Didit API が受け付ける言語コードの 最新の正式な情報源 です。OpenAPI 仕様からは、セッションレベルの language フィールドと、セッションの作成 の contact_details.email_lang フィールドの両方で参照されています。

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

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

​
対応言語の一覧

以下のセットは、サービス内の EMAIL_TRANSLATIONS のキーと一致しています。確認UIとメールのローカライズ層は同じ辞書を読み込むため、この表のどのコードも language と email_lang の両方で使えます。 右から左に表示される言語は3つあり、確認UIとメールの両方で右から左に描画されます。アラビア語 (ar)、ヘブライ語 (he)、ペルシア語 / ファルシー (fa) です。
これらのコードを受け付けるバリデーターは BaseSessionSerializer.validate_language と ContactDetailsSerializer.validate_email_lang です。どちらも、上の表にない値に対して、メッセージ "Invalid language. Supported languages are: ..." (または "Invalid email language...") とともに 400 を返します。

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

確認UIは、ユーザーのブラウザの言語を 自動検出 します。ブラウザの言語が上記のコードのいずれかである場合、画面とメールはその言語で表示されます。そうでない場合、UI は 英語 にフォールバックします。 セッションの作成時に、言語を明示的に設定することもできます。
language だけを設定した場合、email_lang も渡さない限り、メールは引き続き英語がデフォルトになります。逆に、email_lang を設定しても、ブラウザ上の UI の言語は変わりません。この2つのフィールドは独立しています。

​
地域別のバリアント

3つのコードは 地域別のバリアント で、対象の利用者がわかっている場合はこちらを優先してください。
  • pt-BR - ブラジルのポルトガル語 (ブラジルのユーザーには、汎用の pt ではなくこちらを使用します)。
  • zh-CN - 簡体字中国語 (中国本土、シンガポール)。
  • zh-TW - 繁体字中国語 (台湾、香港、マカオ)。
汎用のコード pt と zh も受け付けられます。どのバリアントを選んでも、変わるのは語彙と文字だけで、基盤となる確認ロジックには影響しません。

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

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

​
関連リファレンス

セッション作成API

確認を開始するときに language と email_lang を渡す場所です。

セッションステータスの更新

ステータス変更通知メールの email_language を設定します。

Webhook

確認結果を受け取ります。ペイロードには選択された language が含まれます。

データモデル

セッション、連絡先情報、ステータスの正式なスキーマです。