Zum Hauptinhalt springen
Diese Seite ist die aktuelle Referenz für die von der Didit-API akzeptierten Sprachcodes. Sowohl in den OpenAPI-Spezifikationen für das sitzungsweite Feld language als auch für das Feld contact_details.email_lang bei Sitzung erstellen wird auf sie verwiesen.

​
Wo diese Codes gelten

Überall dort, wo eine Sprache konfiguriert werden kann, wird derselbe Satz an Codes akzeptiert: Sofern das Browser-Gebietsschema des Benutzers unterstützt wird, erkennt die Verifizierungs-UI dieses automatisch; andernfalls wird auf Englisch (en) zurückgegriffen. Wenn Sie email_lang nicht übergeben, fallen E-Mails auf en zurück. Bei allen Werten wird zwischen Groß- und Kleinschreibung unterschieden – verwenden Sie exakt die Codes aus der folgenden Tabelle.

​
Alle unterstützten Sprachen

Die folgende Liste spiegelt die Schlüssel von EMAIL_TRANSLATIONS im Dienst wider – sowohl die Verifizierungs-UI als auch die Ebenen zur E-Mail-Lokalisierung greifen auf dasselbe Wörterbuch zu, sodass jeder Code in dieser Tabelle sowohl für language als auch für email_lang funktioniert. Drei Sprachen werden sowohl in der Verifizierungs-UI als auch in E-Mails von rechts nach links dargestellt: Arabisch (ar), Hebräisch (he) und Persisch / Farsi (fa).
Die Validatoren, die diese Codes akzeptieren, sind BaseSessionSerializer.validate_language und ContactDetailsSerializer.validate_email_lang. Beide lösen für jeden Wert außerhalb der obigen Tabelle einen 400-Fehler mit der Nachricht "Invalid language. Supported languages are: ..." (oder "Invalid email language...") aus.

​
Eine Sprache für eine Sitzung auswählen

Die Verifizierungs-UI erkennt die Browsersprache des Benutzers automatisch. Entspricht die Browsersprache einem der oben aufgeführten Codes, werden die Benutzeroberfläche und die E-Mails in dieser Sprache bereitgestellt. Andernfalls weicht die Benutzeroberfläche auf Englisch aus. Sie können die Sprache beim Erstellen einer Sitzung auch explizit festlegen:
Wenn Sie nur language festlegen, verwenden E-Mails weiterhin standardmäßig Englisch, es sei denn, Sie übergeben auch email_lang. Umgekehrt ändert das Festlegen von email_lang nicht die UI-Sprache im Browser – die beiden Felder sind voneinander unabhängig.

​
Ländervarianten

Drei Codes sind regionale Varianten, die Sie bevorzugen sollten, wenn Sie Ihre Zielgruppe kennen:
  • pt-BR – Brasilianisches Portugiesisch (für brasilianische Benutzer anstelle des generischen pt verwenden).
  • zh-CN – Vereinfachtes Chinesisch (Festlandchina, Singapur).
  • zh-TW – Traditionelles Chinesisch (Taiwan, Hongkong, Macau).
Die generischen Codes pt und zh werden ebenfalls akzeptiert; die gewählte Variante wirkt sich lediglich auf den Wortschatz und die Schriftzeichen aus, nicht auf die zugrundeliegende Verifizierungslogik.

​
Eine neue Sprache anfragen

Wenn Sie eine Sprache benötigen, die oben nicht aufgeführt ist, wenden Sie sich an unser Support-Team. Wir können eine neue Sprache in der Regel innerhalb von 24 Stunden nach Ihrer Anfrage zu EMAIL_TRANSLATIONS und der Verifizierungs-UI hinzufügen – nach dem Hinzufügen wird diese Seite aktualisiert und der neue Code wird von der API sofort akzeptiert. Kontaktieren Sie uns unter hello@didit.me oder über Ihren gewohnten Support-Kanal, um Unterstützung für weitere Sprachen anzufragen.

​
Verwandte Referenzen

Create Session API

Hier werden language und email_lang beim Starten einer Verifizierung übergeben.

Update Session Status

Legt email_language für die Benachrichtigungs-E-Mail bei Statusänderungen fest.

Webhooks

Verifizierungsergebnisse empfangen – Payloads enthalten die ausgewählte language.

Datenmodelle

Kanonisches Schema für Sitzungen, Kontaktdaten und Status.
Zuletzt geändert am 7. November 2026