Перейти к основному содержанию

​
Где применяются эти коды

Эта страница является актуальным источником кодов языков, которые принимает API Didit. На неё ссылаются OpenAPI-спецификации для поля language на уровне сессии и для поля contact_details.email_lang в запросе Создание сессии. Один и тот же набор кодов принимается везде, где можно настроить язык: Если локаль браузера пользователя поддерживается, интерфейс верификации определяет её автоматически; в противном случае используется английский (en). Если вы не передаёте email_lang, письма отправляются на английском (en). Все значения чувствительны к регистру, поэтому используйте точные коды из таблицы ниже.

​
Все поддерживаемые языки

Список ниже совпадает с ключами EMAIL_TRANSLATIONS в сервисе: и интерфейс верификации, и слой локализации email читают один и тот же словарь, поэтому любой код из этой таблицы работает и для language, и для email_lang. Три языка отображаются справа налево как в интерфейсе верификации, так и в письмах: арабский (ar), иврит (he) и персидский (фарси) (fa).
Коды проверяют валидаторы BaseSessionSerializer.validate_language и ContactDetailsSerializer.validate_email_lang. Оба возвращают ошибку с кодом 400 и сообщением "Invalid language. Supported languages are: ..." (или "Invalid email language...") для любого значения, которого нет в таблице выше.

​
Выбор языка для сессии

Интерфейс верификации автоматически определяет язык браузера пользователя. Если язык браузера соответствует одному из приведённых выше кодов, интерфейс и письма выводятся на этом языке. В противном случае интерфейс переходит на английский. Язык можно также задать явно при создании сессии:
Если вы задаёте только language, письма всё равно выводятся на английском, пока вы не передадите и email_lang. И наоборот: установка email_lang не меняет язык интерфейса в браузере, эти два поля независимы.

​
Региональные варианты

Три кода являются региональными вариантами, которые стоит предпочесть, если вы знаете свою аудиторию:
  • pt-BR — бразильский португальский (используйте вместо общего pt для пользователей из Бразилии).
  • zh-CN — упрощённый китайский (материковый Китай, Сингапур).
  • zh-TW — традиционный китайский (Тайвань, Гонконг, Макао).
Общие коды pt и zh тоже принимаются. Выбранный вариант влияет только на лексику и иероглифы, но не на логику верификации.

​
Запрос нового языка

Если нужного вам языка нет в списке выше, свяжитесь с нашей службой поддержки. Обычно мы можем добавить новый язык в EMAIL_TRANSLATIONS и в интерфейс верификации в течение 24 часов после вашего запроса. После добавления эта страница обновляется, и новый код сразу принимается API. Напишите нам на hello@didit.me или через привычный канал поддержки, чтобы запросить поддержку дополнительных языков.

​
Связанные материалы

API создания сессии

Где передаются language и email_lang при запуске верификации.

Обновление статуса сессии

Задаёт email_language для письма с уведомлением об изменении статуса.

Webhook

Получайте результаты верификации: в payload содержится выбранный language.

Модели данных

Каноническая схема для сессий, контактных данных и статусов.
Последнее изменение 7 ноября 2026 г.