Notell API Docs
English

Справочник

Языки

Язык интерфейса игры выбирается при каждом запуске полем lang метода /playGame.do.

Коды#

lang — стандартный код BCP 47: en, de, pt-BR, zh-Hans, zh-Hant, es-419, … Перед использованием платформа его нормализует:

  • регистр не важен (PT-br → pt-BR), вместо - допустим _ (pt_BR);
  • несколько распространённых вариантов приводятся к коду, который используют игры:
Вы отправляетеИспользуется
zh, zh-CN, zh-SGzh-Hans
zh-TW, zh-HKzh-Hant
nb, nnno
pt-PTpt
en-US, en-GBen
sr-Latn-RSsr-Latn
uz-Latn-UZuz-Latn

Код — это язык из 2–3 букв и необязательные подтеги через - или _ (буквы и цифры), всего не более 16 символов.

Какие языки поддерживает игра#

Каждая игра принимает ровно те языки, которые предлагает её клиент. Список — массив languages игры в GET /games/catalog и столбец Языки в списке игр. По всему каталогу 47 языков:

КодЯзыкКод клиентаИгр
arарабский—642
bgболгарский—990
bnбенгальский—233
csчешский—981
daдатский—999
deнемецкий—1010
elгреческий—990
enанглийский—1010
esиспанский—1010
etэстонский—990
faперсидский—635
fiфинский—1010
frфранцузский—1010
hiхинди—123
hrхорватский—919
huвенгерский—990
hyармянский—870
idиндонезийский—1010
isисландский—116
itитальянский—1010
jaяпонский—1010
kaгрузинский—987
koкорейский—1010
ltлитовский—968
lvлатышский—953
mkмакедонский—115
msмалайский—755
nlнидерландский—990
noнорвежский—1009
plпольский—990
ptпортугальский—992
pt-BRбразильский португальскийEndorphina pt_BR, Nolimit City bp351
roрумынский—1010
ruрусский—1010
skсловацкий—891
slсловенский—38
srсербский—755
sr-Latnсербский (латиница)Endorphina sr_Latn7
svшведский—1010
thтайский—1010
tlфилиппинский—230
trтурецкий—1010
ukукраинский—888
uz-Latnузбекский (латиница)Endorphina uz_Latn7
viвьетнамский—1010
zh-Hansкитайский, упрощенное письмоEndorphina zh_Hans, Pragmatic Play zh, Nolimit City zh782
zh-Hantкитайский, традиционное письмоEndorphina zh_Hant, Pragmatic Play zt, Nolimit City zh-hant1005

Язык по умолчанию и ошибки#

  • Если lang не указан, используется язык проекта по умолчанию (админ-панель → Projects → Technical; панель предлагает русский, английский и украинский). Если игра не предлагает этот язык, запуск завершается UNSUPPORTED_LANGUAGE: передавайте lang явно.
  • Если код некорректен или игра его не предлагает, запуск возвращает HTTP 400 UNSUPPORTED_LANGUAGE. Выберите другой язык или не передавайте lang.

Смена языка#

Запустите игру ещё раз с другим lang. Если у игрока есть незавершённый раунд, та же сессия продолжается на новом языке; иначе создаётся новая сессия. Сессия хранит стандартный код, а игра получает код, который ожидает её клиент.

Язык сессии возвращается в meta.language ответа запуска.

Документация для операторов и интеграторов.Платформа TEST_ONLY: невыводимые единицы, реальные платежи не используются.