Guides / Working with data / Clients and versions

Clients and versions

Pick the app you run as with three fields: os, app_flavour and app_version. 8 app flavours, 40+ releases.

The three fields

FieldValuesDefault
osandroid, iosandroid
app_flavourtiktok, lite, lite_coin, pro, studio, shop, tv, douyintiktok
app_versionA release of that appThe current default for (os, app_flavour)

They replace the older platform, product, edition and version fields. app_version is optional everywhere: leave it out and you get the current default.

Supported builds

osapp_flavouraidDefaultReleases
androidtiktok TikTok123347.6.347.7.3, 47.7.2, 47.7.1, 47.6.3, 47.6.2, 47.5.41, 47.5.3, 47.5.1, 47.4.3, 47.4.2, 47.1.4, 47.1.3, 47.1.2, 47.0.41, 47.0.3, 46.9.3, 46.8.3, 46.7.3, 46.5.3, 46.1.3, 45.9.3, 45.5.4, 45.0.3, 44.9.3, 44.6.4, 41.8.3
iostiktok TikTok123347.5.047.5.0, 47.4.0, 46.9.0
androidlite TikTok Lite134047.6.147.7.4, 47.7.3, 47.7.2, 47.6.1, 47.5.2, 47.5.1, 47.4.2, 47.1.5, 47.1.1, 47.0.3, 45.0.57
androidlite_coin TikTok Lite (coin)47382447.6.347.6.3, 47.5.3, 47.4.3, 47.1.4, 47.0.3, 46.9.3
androidpro TikTok Pro123347.6.347.6.3, 47.4.3, 47.0.3, 46.9.3, 46.8.3, 46.1.3
androidstudio TikTok Studio866044.6.344.6.3, 44.6.2, 32.9.6, 32.9.5
iosstudio TikTok Studio56775344.6.344.6.3
androidshop TikTok Shop · Shop OEC / SDUI123347.5.4147.5.41
iosshop TikTok Shop · Shop OEC / SDUI123347.5.047.5.0
androidtv TikTok TV408212.3.7.112.3.7.1
androiddouyin Douyin112840.8.040.8.0
iosdouyin Douyin112840.8.040.8.0

Where they apply

POST /v1/crypto/sign and POST /v1/devices/provision take them in the body. Gateway reads take them as optional query parameters. Connected sessions keep the client of the device they were bound to. GET /v1/apps/versions lists the same table as JSON.