API reference / Devices, signing & primitives / MSSDK decrypt

MSSDK decrypt

Decrypt and inspect an external MSSDK binary frame into decoded bytes and JSON.

POSTapi.tikultra.com/v1/crypto/mssdk/decryptPrimitive · 2 credits

Upstream: local · MSSDK frame cipher inspector
Access: Every plan
Runs on: Primitive
Client: os, app_flavour, app_version selectable
Billing: Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Body

Send JSON with content-type: application/json.

operationstringrequired

MSSDK endpoint operation that produced the frame. One of get_seed, get_token, report, dyn_task, settings, app_attest, get_dctoken.

payload_base64stringrequired

Base64 MSSDK request or response frame captured from your own device. For example AQAAAMgBAAB7ImFpZCI6MTIzMywic2RrX3ZlcnNpb24iOiJ2MDUuMDMuMDMtb3YtYW5kcm9pZCIsInNjZW5lIjoxMTJ9.

osstring

android or ios. One of android, ios.

app_flavourstring

Which app to run as. One of tiktok, lite, lite_coin, pro, studio, shop, tv, douyin.

app_versionstring

A release of that app. Defaults to the current default for (os, app_flavour). For example 47.5.41.

device_idstring

Optional device ID associated with the capture. For example 7392011847562901234.

Client and egress

Select target client release via os, app_flavour and app_version in the request body above. See Clients and versions.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

osstring

Decoded os value.

app_flavourstring

Decoded app flavour value.

app_versionstring

Decoded app version value.

platformstring

Decoded platform value.

productstring

Decoded product value.

editionstring

Decoded edition value.

app_familystring

Decoded app family value.

output_base64string

Decoded output base64 value.

output_jsonobject

Structured output json metadata.

output_json.operationstring

Decoded operation value.

output_json.aidinteger

Decoded aid value.

output_json.sdk_versionstring

Decoded sdk version value.

output_json.sceneinteger

Decoded scene value.

output_json.device_idstring

Provisioned mobile device identifier.

output_json.report_seqinteger

Decoded report seq value.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

import { TikUltra } from 'tikultra' const client = new TikUltra({ apiKey: process.env.TIKULTRA_KEY }) const res = await client.crypto.mssdkDecrypt({ operation: 'report', payload_base64: 'AQAAAMgBAAB7ImFpZCI6MTIzMywic2RrX3ZlcnNpb24iOiJ2MDUuMDMuMDMtb3YtYW5kcm9pZCIsInNjZW5lIjoxMTJ9', os: 'android', app_flavour: 'tiktok', app_version: '47.5.41', device_id: '7392011847562901234', }) console.log(res.creditsCost, res.data)

{ "os": "android", "app_flavour": "tiktok", "app_version": "47.5.41", "platform": "android", "product": "tiktok", "edition": "standard", "app_family": "tiktok", "output_base64": "eyJvcGVyYXRpb24iOiJyZXBvcnQiLCJhaWQiOjEyMzMsInNka192ZXJzaW9uIjoidjA1LjAzLjAzLW92LWFuZHJvaWQiLCJzY2VuZSI6MTEyLCJkZXZpY2VfaWQiOiI3MzkyMDExODQ3NTYyOTAxMjM0IiwicmVwb3J0X3NlcSI6M30=", "output_json": { "operation": "report", "aid": 1233, "sdk_version": "v05.03.03-ov-android", "scene": 112, "device_id": "7392011847562901234", "report_seq": 3, "timestamp_sec": 1794440492 } }