staqlydocs
REST APIAPI referenceChannels

An event from TikTok

An event from TikTok (a video made public or no longer public, the app removed from an account)

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

POST
/v1/tiktok/webhook

The callback URL to enter in the TikTok developer portal (Webhooks) is <dashboard>/api/v1/tiktok/webhook. Signed by TikTok with the app's client secret (TikTok-Signature: t=<time>,s=<HMAC-SHA256 of "<time>.<body>">); off (404) until the server has PROVIDER_TIKTOK_CLIENT_SECRET. A video made public gets its id and link and its numbers read; one no longer public is checked; a removed app queues a check of that account's channels. The body is only a hint: the checks ask TikTok.

Header Parameters

TikTok-Signature*string

Request Body

application/json
  1. body
[key: string]?any

Response Body

OK

application/json
  1. response
handled*integer

Posts or channels the event touched

Example Request
curl -X POST 'https://staqly.example.com/v1/tiktok/webhook' \  -H 'TikTok-Signature: string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "handled": 0}