లాగిన్ చేయండిఉచిత ట్రయల్ ప్రారంభించండి
easyCoexistence అధికారిక APIలు

TikTok వెబ్‌హుక్‌లను ధృవీకరించడం: సిగ్నేచర్ హెడర్ మరియు దాన్ని తనిఖీ చేసే విధానం

TikTok API for Business ప్రతి వెబ్‌హుక్ డెలివరీని Tiktok-Signature హెడర్‌లో సంతకం చేస్తుంది, రూపం t=<unix seconds>,s=<hex>. ఇక్కడ s అనేది t విలువ, ఒక డాట్ మరియు రిక్వెస్ట్ బాడీపై, డెవలపర్ యాప్ సీక్రెట్‌తో కీ చేసిన HMAC-SHA256. ధృవీకరించడానికి, అందిన రా బాడీపై ఆ HMAC ను మళ్లీ లెక్కించండి, s తో స్థిర సమయంలో (constant time) పోల్చండి, మరియు పాత t ను తిరస్కరించండి.

easyCoexistence తన యాప్ అందుకునే ప్రతి కామెంట్ ఈవెంట్‌పై TikTok సిగ్నేచర్‌ను తనిఖీ చేస్తుంది.

t and s

Tiktok-Signature యొక్క రెండు భాగాలు: డెలివరీ యొక్క Unix టైమ్‌స్టాంప్ సెకన్లలో, మరియు దాని కోసం TikTok రూపొందించిన సిగ్నేచర్.

5 seconds

TikTok యొక్క Node సాంపిల్‌లోని acceptableDelay, అది సరిగ్గా సంతకం చేసినప్పటికీ, అంతకంటే పాత డెలివరీని తిరస్కరిస్తుంది.

x-tt-logid

ప్రతి డెలివరీ యొక్క ప్రత్యేక ID ను కలిగి ఉండే హెడర్, ట్రబుల్‌షూటింగ్ కోసం లాగ్ చేయమని TikTok రిసీవర్లను కోరుతుంది.

BRAND_MENTION

మెన్షన్ వెబ్‌హుక్‌ల ఈవెంట్ టైప్, దీని సబ్‌స్క్రిప్షన్ గైడ్ అదే సిగ్నేచర్ ధృవీకరణను సూచిస్తుంది.

v1

easyCoexistence యొక్క X-EC-Signature హెడర్‌లోని సిగ్నేచర్ భాగం: t, ఒక డాట్ మరియు రా బాడీపై HMAC-SHA256.

Tiktok-Signature హెడర్ ఎలా ఉంటుంది?

రెండు భాగాలు, కామాతో వేరు చేయబడ్డాయి: t, ఆ డెలివరీ యొక్క Unix టైమ్‌స్టాంప్ సెకన్లలో, మరియు s, సిగ్నేచర్, ఇది 64 హెక్సాడెసిమల్ అక్షరాల పొడవు ఉంటుంది. TikTok పేజీలు ఈ పేరును TikTok-Signature, Tiktok-Signature మరియు tiktok-signature అని రాస్తాయి. HTTP హెడర్ పేర్లు అక్షరాల పెద్ద చిన్న తేడాను పట్టించుకోవు, కాబట్టి చాలా ఫ్రేమ్‌వర్క్‌లు ఇప్పటికే చేస్తున్నట్టే, దాన్ని case-insensitively చదవండి. TikTok నమూనా డెలివరీలోని ఇతర హెడర్లు:

Headers from TikTok's sample delivery
content-type: application/json;charset=UTF-8
user-agent: tiktok-webhook
tiktok-signature: t=1641974633,s=dc023ece112b3a07d809896fd929928a132168d95d2a2e43aab0105fbb291df8
webhook-schema-version: v1.0
x-tt-logid: 202201120803530102451591650189C78

TikTok ఏ బైట్లపై సంతకం చేస్తుంది?

t విలువను స్ట్రింగ్‌గా, తరువాత డాట్, తరువాత బాడీ. TikTok గైడ్ చివరి భాగాన్ని రిక్వెస్ట్ బాడీ యొక్క స్ట్రింగిఫై చేసిన JSON కాపీ అని పిలుస్తుంది, మరియు దాని Node నమూనా, ఇప్పటికే పార్స్ చేసిన ఆబ్జెక్ట్‌పై JSON.stringify రన్ చేయడం ద్వారా ఆ కాపీని పునర్నిర్మిస్తుంది. రెండు సీరియలైజర్లు స్పేసింగ్, కీల క్రమం మరియు escaping పై ఏకీభవించినప్పుడు మాత్రమే ఇది TikTok బైట్లను పునరుత్పత్తి చేస్తుంది, కాబట్టి ఏ JSON మిడిల్‌వేర్ దాన్ని చదవడానికి ముందే, బాడీని అందిన విధంగానే యథాతథంగా హ్యాష్ చేయండి.

ఏ సీక్రెట్ కీ?

డెవలపర్ యాప్ సీక్రెట్, TikTok డెవలపర్ పోర్టల్‌లో My Apps, App Detail, Basic Information కింద దొరుకుతుంది. యాప్ ఇప్పటికే దీన్ని /business/webhook/update/ కు secret గా, మరియు టోకెన్ ఎండ్‌పాయింట్‌లకు client_secret గా పంపుతుంది. యాప్‌ను అధికారం ఇచ్చిన ప్రతి ఖాతాకు ఒకే సీక్రెట్ డెలివరీలపై సంతకం చేస్తుంది, కాబట్టి రిసీవర్‌కు ఖాతాకు ఒక కీ అవసరం లేదు, మరియు యాక్సెస్ టోకెన్ లేదా యాప్ ID ఇందులో భాగం కావు.

Node.js లో దీన్ని ఎలా తనిఖీ చేయాలి?

node:crypto మరియు రా బాడీతో. క్రింది ఫంక్షన్ హెడర్‌ను విడగొడుతుంది, t, డాట్ మరియు బాడీ బైట్లపై HMAC ను మళ్లీ లెక్కిస్తుంది, ఫలితాన్ని స్థిర సమయంలో పోలుస్తుంది, ఆపై t వయస్సును తనిఖీ చేస్తుంది. ఇది సిగ్నేచర్ భాగం పేరును ఆర్గ్యుమెంట్‌గా తీసుకుంటుంది, కాబట్టి అదే కోడ్ easyCoexistence ఫార్వర్డ్‌లను కూడా తనిఖీ చేస్తుంది. అక్కడ ఆ భాగాన్ని v1 అని పిలుస్తారు, మరియు కీ ఖాతా యొక్క సైనింగ్ సీక్రెట్:

Node.js and Express: TikTok's deliveries and easyCoexistence's forwards
import express from "express";
import { createHmac, timingSafeEqual } from "node:crypto";

// Tiktok-Signature reads t=<unix>,s=<hex>; X-EC-Signature reads t=<unix>,v1=<hex>.
function verifySignature(rawBody, header, secret, name, maxAgeSeconds = 300) {
  const parts = {};
  for (const item of String(header ?? "").split(",")) {
    const i = item.indexOf("=");
    if (i > 0) parts[item.slice(0, i).trim()] = item.slice(i + 1).trim();
  }
  const signature = parts[name];
  if (!/^\d+$/.test(parts.t ?? "") || !signature) return false;
  const expected = createHmac("sha256", secret)
    .update(parts.t + ".")
    .update(rawBody) // the bytes exactly as they arrived
    .digest("hex");
  const a = Buffer.from(expected);
  const b = Buffer.from(signature);
  if (a.length !== b.length || !timingSafeEqual(a, b)) return false;
  return Math.abs(Date.now() / 1000 - Number(parts.t)) <= maxAgeSeconds;
}

const app = express();

// TikTok to your own developer app: the app secret, part s
app.post("/webhooks/tiktok", express.raw({ type: "application/json" }), (req, res) => {
  if (!verifySignature(req.body, req.get("tiktok-signature"), process.env.TIKTOK_APP_SECRET, "s")) {
    console.warn("TikTok signature rejected, x-tt-logid:", req.get("x-tt-logid"));
    return res.sendStatus(401);
  }
  res.sendStatus(200); // acknowledge first: TikTok retries anything but a 200
  enqueue(req.body.toString("utf8")); // its content field is itself a JSON string
});

// easyCoexistence to your endpoint: the account's whsec_ secret, part v1
app.post("/webhooks/easycoexistence", express.raw({ type: "application/json" }), (req, res) => {
  if (!verifySignature(req.body, req.get("x-ec-signature"), process.env.EC_SIGNING_SECRET, "v1")) {
    return res.sendStatus(401);
  }
  res.sendStatus(200);
  enqueue(req.body.toString("utf8")); // platform, account_id, external_id, entry
});

ఒక డెలివరీ ఎంత పాతదైతే తిరస్కరించాలి?

TikTok కటాఫ్‌ను రిసీవర్‌కే వదిలేస్తుంది: మీ గడియారం మరియు t మధ్య తేడాను లెక్కించి, అది సహించదగినదో లేదో నిర్ణయించండి, అని దాని గైడ్ చెబుతుంది. దాని Node నమూనా 5 సెకన్లు అనుమతిస్తుంది, ఇది కొన్ని సెకన్లు తప్పుగా ఉన్న సర్వర్ గడియారం నిజమైన డెలివరీలను తిరస్కరించేంత కఠినం. పైన ఉన్న కోడ్ 300 అనుమతిస్తుంది, easyCoexistence తన స్వంత ఫార్వర్డ్‌లపై రిసీవర్లు ఉపయోగించమని కోరే విండో అది. కొలత t నుండి చేయండి, సంతకం కవర్ చేసే డెలివరీ సమయం నుండి, బాడీలోని create_time నుండి కాదు, అది ఈవెంట్ జరిగిన సమయాన్ని సూచిస్తుంది. TikTok నమూనాలో, t, create_time కంటే ఒక సెకను తర్వాత వస్తుంది.

ఎండ్‌పాయింట్ ఏమి ప్రతిస్పందించాలి?

సంతకం సరిగ్గా ఉన్న వెంటనే 200, పని తర్వాత చేయబడుతుంది, ఎందుకంటే TikTok ఏ ఇతర స్టేటస్‌ను విఫలమైన డెలివరీగా పరిగణించి మళ్లీ పంపుతుంది. సంతకం సరిపోకపోతే, TikTok నమూనా 4xx స్టేటస్‌తో ప్రతిస్పందించి, x-tt-logid హెడర్‌ను లాగ్ చేస్తుంది, ఇది మీరు TikTok కు సమస్యను నివేదించినప్పుడు రిక్వెస్ట్‌ను గుర్తిస్తుంది. బాడీలోని client_key డెవలపర్ యాప్‌ను పేర్కొంటుంది, కాబట్టి దాన్ని మీ స్వంత యాప్ ID తో పోల్చడం చౌకైన రెండవ తనిఖీ.

కాల్‌బ్యాక్ URL ఎలా రిజిస్టర్ అవుతుంది, మరియు అది ధృవీకరించబడుతుందా?

ఒకే API కాల్ ద్వారా, మరియు TikTok ముందుగా URL ను పరీక్షించే ఛాలెంజ్ రిక్వెస్ట్‌ను డాక్యుమెంట్ చేయలేదు. POST /business/webhook/update/ app_id, సీక్రెట్, event_type మరియు HTTPS callback_url ను తీసుకుంటుంది: పబ్లిషింగ్ ఈవెంట్‌లకు VIDEO, comment.update కోసం COMMENT, మరియు Mentions API పై brand.mention.event కోసం BRAND_MENTION. ఇవన్నీ ఒకే విధంగా సంతకం చేయబడి వస్తాయి, మరియు GET /business/webhook/list/ ఒక ఈవెంట్ టైప్ కోసం రిజిస్టర్ అయిన URL ను చూపిస్తుంది. మూలాన్ని నిరూపించేది ప్రతి డెలివరీపై ఉన్న సిగ్నేచర్.

easyCoexistence ఫార్వర్డ్ చేసే ఈవెంట్‌లపై Tiktok-Signature ను తనిఖీ చేయగలరా?

లేదు, మరియు దానికి అవసరం కూడా లేదు. TikTok ఆ డెలివరీలపై easyCoexistence యొక్క స్వంత డెవలపర్ యాప్ సీక్రెట్‌తో సంతకం చేస్తుంది, దాన్ని ఏ టూల్ లేదా API ఇవ్వదు. easyCoexistence ప్రతి ఈవెంట్ వచ్చినప్పుడు ఆ సిగ్నేచర్‌ను తనిఖీ చేస్తుంది, విఫలమైన దానికి 401 ఇస్తుంది, client_key మరొక యాప్‌ను పేర్కొనే బాడీని విస్మరిస్తుంది, ఆపై కనెక్ట్ అయిన ఆ ఖాతా యొక్క సైనింగ్ సీక్రెట్‌తో మీకు పంపే ఫార్వర్డ్‌ను X-EC-Signature లో సంతకం చేస్తుంది.

easyCoexistence తాను ఫార్వర్డ్ చేసేదానిపై ఎలా సంతకం చేస్తుంది?

X-EC-Signature హెడర్‌లో, t=<unix>,v1=<hex>. ఇక్కడ t అనేది ఫార్వర్డ్ సమయం, మరియు v1 అనేది t, డాట్ మరియు పంపిన బాడీ ఖచ్చితంగా అలాగే ఉన్న దానిపై హెక్స్ HMAC-SHA256. కీ ఖాతా యొక్క సైనింగ్ సీక్రెట్, whsec_ తరువాత 32 అక్షరాలు, ఉపసర్గతో సహా మొత్తం వాడబడుతుంది. దాని స్వంత హెడర్లలో, easyCoexistence Content-Type మరియు ఈ హెడర్‌ను మాత్రమే సెట్ చేస్తుంది, ఈవెంట్ హెడర్ లేదు, కాబట్టి ఈవెంట్ పేరును entry.event నుండి చదవండి:

A forwarded TikTok comment event, as sent
POST https://hooks.example.com/tiktok/
Content-Type: application/json
X-EC-Signature: t=1793318405,v1=<HMAC_SHA256_HEX>

{"platform":"tiktok","account_id":"<ACCOUNT_ID>","external_id":"<TIKTOK_OPEN_ID>","entry":{"event":"comment.update","create_time":1793318400,"content":{...}}}

v1 = hex(HMAC-SHA256(key = "whsec_<SECRET>", message = "1793318405." + raw body))

సైనింగ్ సీక్రెట్ మార్చబడినప్పుడు ఏమవుతుంది?

కొత్త సీక్రెట్ తదుపరి ఫార్వర్డ్ నుండి సంతకం చేస్తుంది. set_social_webhook_destination లేదా PUT /channels/{id}/webhook ను మళ్లీ కాల్ చేయడం కొత్త సీక్రెట్ ఇస్తుంది మరియు పాతదాన్ని వెంటనే రద్దు చేస్తుంది. ప్రతి ఫార్వర్డ్ ఒక్కసారి మాత్రమే పంపబడుతుంది, కాబట్టి మార్పు సమయంలో మీ సర్వర్ తిరస్కరించిన ఈవెంట్ పోతుంది. కొత్తది డిప్లాయ్ అయ్యే వరకు కొన్ని నిమిషాల పాటు రెండు సీక్రెట్లను అంగీకరించండి. ఛానల్స్ మరియు పోస్ట్‌ల గురించి స్టేటస్ ఈవెంట్‌లు మరొక సీక్రెట్‌ను ఉపయోగిస్తాయి, Dashboard, Profile, Developers నుండి వచ్చేది, మరియు X-EC-Event మరియు X-EC-Delivery హెడర్‌లతో వస్తాయి, సుమారు 33 గంటల పాటు మళ్లీ ప్రయత్నించబడతాయి.

సాధారణ పొరపాట్లు

  • ఫ్రేమ్‌వర్క్ ఇప్పటికే పార్స్ చేసిన బాడీని వెరిఫై చేయడం. JSON మిడిల్‌వేర్ ఒక ఆబ్జెక్ట్ ఇస్తుంది, మరియు దాన్ని మళ్లీ సీరియలైజ్ చేయడం TikTok బైట్లను మార్చవచ్చు. వెబ్‌హుక్ రూట్‌లో రా బాడీని చదవండి.
  • సంతకం విఫలమైన డెలివరీకి 200 ఇవ్వడం. TikTok 200 చూసిన వెంటనే ఈవెంట్ పంపడం ఆపుతుంది, కాబట్టి తప్పుగా కాన్ఫిగర్ చేసిన తనిఖీ తిరస్కరించిన నిజమైన ఈవెంట్ పోతుంది. 4xx ఇస్తే TikTok 72 గంటల వరకు మళ్లీ ప్రయత్నిస్తుంది.
  • సిగ్నేచర్‌లను === తో పోల్చడం, TikTok నమూనా చేస్తున్నట్టు. timingSafeEqual వంటి స్థిర సమయ పోలిక, నకిలీ సిగ్నేచర్ ఎంతవరకు సరిపోయిందో బయటపెట్టదు.
  • easyCoexistence సీక్రెట్‌ను Base64-decode చేయడం లేదా దాని whsec_ ఉపసర్గను కత్తిరించడం. HMAC కీ మొత్తం స్ట్రింగ్, ఒకసారి చూపిన విధంగానే.
EasyCoexistenceతో దీన్ని చేయడం

ఆ తర్వాత కనెక్ట్ అయిన ఖాతా కామెంట్ ఈవెంట్‌లను మీ HTTPS ఎండ్‌పాయింట్‌కు ఫార్వర్డ్ చేస్తుంది, X-EC-Signature లో ఆ ఖాతాకే ప్రత్యేకమైన సీక్రెట్‌తో సంతకం చేసి. ఎండ్‌పాయింట్‌ను Claude లేదా ChatGPT నుండి set_social_webhook_destination తో, లేదా PUT /channels/{id}/webhook తో సెట్ చేయండి. ప్రతి కనెక్షన్‌కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించే కొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.

తరచుగా అడిగే ప్రశ్నలు

x-tt-logid అంటే ఏమిటి TikTok వెబ్‌హుక్‌లో?

ప్రతి డెలివరీ యొక్క ప్రత్యేక ID ను కలిగి ఉండే హెడర్. TikTok దాన్ని లాగ్ చేయమని రిసీవర్లను కోరుతుంది, ఎందుకంటే మీరు TikTok కు సమస్యను నివేదించినప్పుడు అది రిక్వెస్ట్‌ను గుర్తిస్తుంది.

కొత్త TikTok వెబ్‌హుక్ URL ను ధృవీకరించడానికి TikTok ఛాలెంజ్ పంపుతుందా?

API for Business కోసం TikTok ఏదీ డాక్యుమెంట్ చేయలేదు. /business/webhook/update/ కాల్ URL ను రిజిస్టర్ చేస్తుంది, ఆ తర్వాత డెలివరీలు Tiktok-Signature తో వస్తాయి, వాటిని మీ సర్వర్ తనిఖీ చేస్తుంది.

నా TikTok వెబ్‌హుక్ సిగ్నేచర్ ఎందుకు ఎప్పుడూ సరిపోదు?

ఇన్‌పుట్ మరియు కీని తనిఖీ చేయండి: HMAC లో t, డాట్ మరియు అందిన రా బాడీ ఉండాలి, యాప్ సీక్రెట్ వాడాలి, మరియు మొత్తం హెడర్ కాకుండా s= తర్వాత ఉన్న విలువతో పోల్చాలి.

easyCoexistence ఫార్వర్డ్ చేసిన TikTok ఈవెంట్లను నేను ఎలా ధృవీకరించాలి?

X-EC-Signature మరియు డెస్టినేషన్ సెట్ చేసినప్పుడు చూపిన సైనింగ్ సీక్రెట్‌తో: t, డాట్ మరియు రా బాడీపై HMAC-SHA256 మళ్లీ లెక్కించి, v1 తో పోల్చి, 5 నిమిషాల కంటే పాత t ను తిరస్కరించండి.

చదవడం కొనసాగించండి

TikTok వ్యాపార API వెబ్‌హుక్‌ల సెటప్TikTok వెబ్‌హుక్‌లకు ఎలా సబ్‌స్క్రైబ్ చేయాలి: /business/webhook/update/, VIDEO, COMMENT ఈవెంట్‌లు, కాల్‌బ్యాక్ నియమాలు, Tiktok-Signature.TikTok కామెంట్ వెబ్‌హుక్ ఈవెంట్‌లుTikTok comment.update వెబ్‌హుక్ కామెంట్‌లు, రిప్లైలను నివేదించే విధానం, ప్రతి ఈవెంట్‌లో ఏముంటుంది, అవి మీ ఎండ్‌పాయింట్‌కు సంతకంతో ఎలా చేరతాయి.API ద్వారా TikTok మెన్షన్‌లు: ఖాతాను మెన్షన్ చేసే పోస్ట్‌లు మరియు కామెంట్‌లను కనుగొనడంTikTok Mentions API: వ్యాపార ఖాతాను మెన్షన్ చేసే పబ్లిక్ పోస్ట్‌లు, కామెంట్‌లు, ఎండ్‌పాయింట్‌లు, స్కోప్, ఆలస్యం, వెబ్‌హుక్.TikTok API రేట్ పరిమితులు: ప్రతి ఖాతా, యాప్ మరియు ఎండ్‌పాయింట్‌కు అభ్యర్థనలుTikTok API రేట్ పరిమితులు: ప్రతి ఖాతా, ఎండ్‌పాయింట్‌కు నిమిషానికి 40 కాల్స్, Accounts API కోసం యాప్‌కు నిమిషానికి 600 లేదా 1,000, నాలుగు స్థాయిలు.TikTok API for Business యాక్సెస్ టోకెన్లు: 24 గంటలు, రిఫ్రెష్ మరియు రద్దుTikTok API for Business టోకెన్లు ఎలా జారీ అవుతాయి: auth_code మార్పిడి, 24 గంటల యాక్సెస్ టోకెన్, ఏడాది రిఫ్రెష్ టోకెన్, పునరుద్ధరణ, రద్దు.

మీ మొదటి ఛానెల్‌ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.

ప్లాట్‌ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్‌ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.

  • 3 రోజులు ఉచితం
  • ఎప్పుడైనా రద్దు చేయండి
  • అధికారిక APIలు మాత్రమే
  • 24/7 పర్యవేక్షణ

ధృవీకరించిన తేదీ