Sign TikTok URL

POST/tiktok/signing/encrypt/sign_url

Sign a non-LIVE TikTok URL. This is NOT available to customers in any public package, and access is approved on a case-by-case basis.

Query Parameters

clientstring= "ttlive-other"

Request Body

Required

Config for the signature generation

url*string
userAgentstring
methodenum
sessionIdstring
ttTargetIdcstring
ttwidstring
payloadstring
typeenum
includeBrowserParamsboolean
includeVerifyFpenum

Responses

200Ok

Response Attributes

code*number (double)
messagestring
responseobject
Request
Response200

Decrypt TikTok str data

POST/tiktok/signing/decrypt/str-data

Decode a TikTok str-data payload into the behaviour telemetry object it encodes.

Request Body

Required

The payload to decode

data*string

The str-data token to decode.

Responses

200Ok

Response Attributes

code*number (double)
messagestring
dataobject

The decoded payload. Free-form: the script's field set changes without notice.

Request
Response200

Decrypt TikTok ec data

POST/tiktok/signing/decrypt/ec-data

Decode a TikTok ecData payload, the environment report webmssdk posts to /web/report, into the fields it carries.

Request Body

Required

The payload to decode

data*string

The ecData.data JSON string from a /web/report body, or the whole report as JSON text.

Responses

200Ok

Response Attributes

code*number (double)
messagestring
dataobject

The decoded report as objects keyed by field id, its trailer under _trailer. Free-form, and lossy: field order cannot be recovered from it.

treeunknown[]

The same report as the [id, type, value] tuple tree it arrived as, in wire order, with string and integer leaves in plaintext. Lossless.

Request
Response200

Decrypt TikTok x gnarly

POST/tiktok/signing/decrypt/x-gnarly

Decode a TikTok x-gnarly signature payload into its fields. Only the fields a captured token confirms are given names; the rest are returned under their index as unknown_<index> rather than guessed at.

Query Parameters

versionenum

Request Body

Required

The payload to decode

data*string

The x-gnarly token to decode.

Responses

200Ok

Response Attributes

code*number (double)
messagestring
dataobject

Decoded fields under their mapped names. Fields the version does not map appear as unknown_<index>.

Request
Response200

Decrypt TikTok x dynosaur

POST/tiktok/signing/decrypt/x-dynosaur

Decode a TikTok x-dynosaur signature payload into its records. Unlike the other signing payloads its leading byte is a bit-field rather than a constant marker, so the sign type and mode are returned alongside the records.

Query Parameters

versionenum

Request Body

Required

The payload to decode

data*string

The x-dynosaur token to decode.

Responses

200Ok

Response Attributes

code*number (double)
messagestring
headerobject

The token's leading bit-field: sign type, flag and mode.

dataobject

Decoded records under their mapped names. Records the version does not map appear as field_<tag>.

unknown_tagsnumber (double)[]

Record tags carried by the token but missing from this version's field map.

truncatedboolean

A trailing fragment could not be read as a whole record. The records above are still valid.

Request
Response200