Notell API Docs
Русский

Reference

Languages

The game interface language is chosen per launch with the lang field of /playGame.do.

Codes#

lang is a standard BCP 47 code: en, de, pt-BR, zh-Hans, zh-Hant, es-419, … The platform normalises it before use:

  • case does not matter (PT-br → pt-BR), and _ is accepted instead of - (pt_BR);
  • a few common variants are mapped to the code the games use:
You sendUsed as
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

The code is a 2–3 letter language followed by optional subtags separated by - or _ (letters and digits), at most 16 characters in total.

Which languages a game supports#

Each game accepts exactly the languages its client offers. The list is the languages array of the game in GET /games/catalog and the Languages column on the games list. Across the whole catalog there are 47 languages:

CodeLanguageClient codeGames
arArabic—642
bgBulgarian—990
bnBangla—233
csCzech—981
daDanish—999
deGerman—1010
elGreek—990
enEnglish—1010
esSpanish—1010
etEstonian—990
faPersian—635
fiFinnish—1010
frFrench—1010
hiHindi—123
hrCroatian—919
huHungarian—990
hyArmenian—870
idIndonesian—1010
isIcelandic—116
itItalian—1010
jaJapanese—1010
kaGeorgian—987
koKorean—1010
ltLithuanian—968
lvLatvian—953
mkMacedonian—115
msMalay—755
nlDutch—990
noNorwegian—1009
plPolish—990
ptPortuguese—992
pt-BRBrazilian PortugueseEndorphina pt_BR, Nolimit City bp351
roRomanian—1010
ruRussian—1010
skSlovak—891
slSlovenian—38
srSerbian—755
sr-LatnSerbian (Latin)Endorphina sr_Latn7
svSwedish—1010
thThai—1010
tlFilipino—230
trTurkish—1010
ukUkrainian—888
uz-LatnUzbek (Latin)Endorphina uz_Latn7
viVietnamese—1010
zh-HansSimplified ChineseEndorphina zh_Hans, Pragmatic Play zh, Nolimit City zh782
zh-HantTraditional ChineseEndorphina zh_Hant, Pragmatic Play zt, Nolimit City zh-hant1005

Default language and errors#

  • If lang is omitted, the project default language is used (admin panel → Projects → Technical settings; the panel offers Russian, English and Ukrainian). If the game does not offer that default, the launch fails with UNSUPPORTED_LANGUAGE: send lang explicitly.
  • If the code is malformed or the game does not offer it, the launch is answered with HTTP 400 UNSUPPORTED_LANGUAGE. Choose another language or omit lang.

Switching language#

Launch again with another lang. If the player has an unfinished round, the same session continues in the new language; otherwise a new session is created. The session stores the standard code and the game receives the code its own client expects.

The session language is returned in meta.language of the launch response.

Documentation for operators and integrators.TEST_ONLY platform: non-withdrawable units, no real payments.