لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

TikTok ویب ہکس کی تصدیق: سگنیچر ہیڈر اور اسے چیک کرنے کا طریقہ

TikTok کا API for Business ہر ویب ہک ڈیلیوری کو Tiktok-Signature ہیڈر میں سائن کرتا ہے، جس کی شکل t=<unix seconds>,s=<hex> ہے۔ s وہ HMAC-SHA256 ہے جو t کی ویلیو، نقطہ اور body پر بنایا جاتا ہے، جسے ڈیولپر ایپ کے سیکرٹ سے کلید بنایا جاتا ہے۔ تصدیق کے لیے وصول شدہ خام body پر یہ HMAC دوبارہ بنائیں، اسے constant time میں s سے موازنہ کریں، اور پرانا t مسترد کریں۔

easyCoexistence ہر کمنٹ ایونٹ پر جو اس کی ایپ وصول کرتی ہے TikTok کا سگنیچر چیک کرتا ہے، پھر کنیکٹڈ اکاؤنٹ کے کمنٹ ایونٹس آپ کے HTTPS اینڈ پوائنٹ پر فارورڈ کرتا ہے، جنہیں X-EC-Signature میں صرف اس اکاؤنٹ کے سیکرٹ سے سائن کیا جاتا ہے۔

t and s

Tiktok-Signature کے دو حصے: ڈیلیوری کا Unix ٹائم اسٹیمپ سیکنڈز میں، اور TikTok کی بنائی ہوئی سگنیچر۔

5 seconds

TikTok کے Node نمونے میں acceptableDelay، جو درست سائن شدہ مگر اس سے پرانی ڈیلیوری کو مسترد کرتا ہے۔

x-tt-logid

وہ ہیڈر جو ہر ڈیلیوری کی منفرد ID رکھتا ہے، جسے TikTok ٹربل شوٹنگ کے لیے لاگ کرنے کو کہتا ہے۔

BRAND_MENTION

mention ویب ہکس کا ایونٹ ٹائپ، جس کی سبسکرپشن گائیڈ اسی سگنیچر تصدیق کی طرف اشارہ کرتی ہے۔

v1

easyCoexistence کے X-EC-Signature ہیڈر کا سگنیچر حصہ، جو t، نقطہ اور خام body کا HMAC-SHA256 ہے۔

Tiktok-Signature ہیڈر کیسا دکھتا ہے؟

دو حصے ہیں جو کاما سے الگ ہیں: t، اس ڈیلیوری کا Unix ٹائم اسٹیمپ سیکنڈز میں، اور s، سگنیچر، جو 64 ہیکساڈیسیمل حروف لمبا ہے۔ TikTok کے صفحات نام کو TikTok-Signature، Tiktok-Signature اور tiktok-signature لکھتے ہیں؛ HTTP ہیڈر کے نام کیس سے بے نیاز ہوتے ہیں، اس لیے اسے کیس سے بے نیاز طریقے سے پڑھیں، جیسا کہ زیادہ تر فریم ورک پہلے ہی کرتے ہیں۔ 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 کی ویلیو بطور سٹرنگ، ایک نقطہ، پھر body۔ TikTok کی گائیڈ اس آخری حصے کو درخواست کی body کی stringified JSON کاپی کہتی ہے، اور اس کا Node نمونہ پہلے سے پارس شدہ آبجیکٹ پر JSON.stringify چلا کر کاپی دوبارہ بناتا ہے۔ یہ TikTok کی بائٹس صرف اسی وقت دوبارہ پیدا کرتا ہے جب دونوں سیریلائزر spacing، key order اور escaping پر متفق ہوں۔ اس لیے body کو ویسے ہی ہیش کریں جیسے وہ آئی تھی، کسی JSON middleware کے اسے پڑھنے سے پہلے۔

کون سا سیکرٹ کلید ہے؟

ڈیولپر ایپ کا سیکرٹ، جو TikTok کے ڈیولپر پورٹل پر My Apps، App Detail، Basic Information کے تحت ملتا ہے۔ یہ وہی ویلیو ہے جو ایپ پہلے سے /business/webhook/update/ کو secret کے طور پر، اور ٹوکن اینڈ پوائنٹس کو client_secret کے طور پر بھیجتی ہے۔ ایک سیکرٹ ہر اس اکاؤنٹ کی ڈیلیوری پر سائن کرتا ہے جس نے ایپ کو اجازت دی، اس لیے ریسیور کو ہر اکاؤنٹ کے لیے الگ کلید درکار نہیں، اور نہ ایکسیس ٹوکن اور نہ ایپ ID اس میں شامل ہوتا ہے۔

Node.js میں اسے کیسے چیک کیا جاتا ہے؟

node:crypto اور خام body کے ساتھ۔ نیچے کا فنکشن ہیڈر الگ کرتا ہے، t، نقطہ اور body کی بائٹس پر HMAC دوبارہ بناتا ہے، نتیجے کا constant time میں موازنہ کرتا ہے، اور پھر 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 سے ناپیں، یعنی وہ وقت جس پر سگنیچر محیط ہے، body کے create_time سے نہیں، جو واقعے کے پیش آنے کا وقت بتاتا ہے۔ TikTok کے نمونے میں t، create_time کے ایک سیکنڈ بعد آتا ہے۔

اینڈ پوائنٹ کیا جواب دے؟

سگنیچر درست ہوتے ہی 200، اور کام اس کے بعد کریں، کیونکہ TikTok کسی بھی دوسرے اسٹیٹس کو ناکام ڈیلیوری سمجھ کر دوبارہ بھیجتا ہے۔ جب سگنیچر میچ نہ کرے تو TikTok کا نمونہ 4xx اسٹیٹس دیتا ہے اور x-tt-logid ہیڈر لاگ کرتا ہے، جو TikTok کو مسئلہ رپورٹ کرتے وقت درخواست کی شناخت کرتا ہے۔ body میں client_key ڈیولپر ایپ کا نام بتاتا ہے، اس لیے اسے اپنی ایپ ID سے موازنہ کرنا ایک آسان دوسری جانچ ہے۔

کال بیک URL کیسے رجسٹر ہوتا ہے، اور کیا اس کی تصدیق ہوتی ہے؟

ایک API کال سے، اور TikTok کوئی ایسی چیلنج ریکویسٹ دستاویزی نہیں کرتا جو پہلے URL کو جانچے۔ POST /business/webhook/update/ میں app_id، secret، 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 کا جواب دیتا ہے، ایسی body کو نظر انداز کرتا ہے جس کا client_key کسی اور ایپ کا نام لے، اور پھر اپنے فارورڈ کو اس کنیکٹڈ اکاؤنٹ کے سائننگ سیکرٹ سے X-EC-Signature میں سائن کر کے آپ کو بھیجتا ہے۔

easyCoexistence اپنے فارورڈ کو کیسے سائن کرتا ہے؟

X-EC-Signature ہیڈر میں، t=<unix>,v1=<hex> کی شکل میں، جہاں t فارورڈ کا وقت ہے اور v1 وہ hex HMAC-SHA256 ہے جو t، نقطہ اور بالکل بھیجی گئی body پر بنتا ہے۔ کلید اکاؤنٹ کا سائننگ سیکرٹ ہے، جو whsec_ اور اس کے بعد 32 حروف پر مشتمل ہوتا ہے، اور اسے پورا، prefix سمیت استعمال کیا جاتا ہے۔ اپنے ہیڈرز میں 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 گھنٹے تک دوبارہ کوشش کیے جاتے ہیں۔

عام غلطیاں

  • پارس شدہ body کی تصدیق کرنا۔ JSON middleware ایک آبجیکٹ دیتا ہے، اور اسے دوبارہ سیریلائز کرنے سے TikTok کی بائٹس بدل سکتی ہیں؛ ویب ہک route پر خام body پڑھیں۔
  • ناکام سگنیچر والی ڈیلیوری پر 200 دینا۔ TikTok 200 دیکھتے ہی ایونٹ بھیجنا بند کر دیتا ہے، اس لیے غلط ترتیب شدہ چیک سے مسترد ہونے والا اصل ایونٹ ضائع ہو جاتا ہے؛ 4xx دینے سے TikTok 72 گھنٹے تک دوبارہ کوشش کرتا ہے۔
  • سگنیچر کا موازنہ === سے کرنا، جیسا کہ TikTok کا نمونہ کرتا ہے۔ constant-time موازنہ جیسے timingSafeEqual یہ ظاہر نہیں کرتا کہ جعلی سگنیچر کا کتنا حصہ میچ ہوا۔
  • easyCoexistence کے سیکرٹ کو Base64 ڈی کوڈ کرنا یا whsec_ prefix کاٹنا۔ HMAC کی کلید پوری سٹرنگ ہے، بالکل ویسی جیسی ایک بار دکھائی گئی تھی۔
EasyCoexistence کے ساتھ یہ کام کرنا

Claude یا ChatGPT سے set_social_webhook_destination کے ذریعے، یا PUT /channels/{id}/webhook سے اینڈ پوائنٹ سیٹ کریں۔ فی کنیکشن فی مہینہ US$ 9 سے US$ 0.75 تک، جیسے جیسے آپ کنیکشن شامل کرتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن فری ٹرائل ہے۔

اکثر پوچھے جانے والے سوالات

TikTok ویب ہک میں x-tt-logid کیا ہے؟

ہر ڈیلیوری کی منفرد ID رکھنے والا ہیڈر۔ TikTok وصول کنندگان سے اسے لاگ کرنے کو کہتا ہے، کیونکہ TikTok کو مسئلہ رپورٹ کرتے وقت یہی درخواست کی شناخت کرتا ہے۔

کیا TikTok نئے ویب ہک URL کی تصدیق کے لیے چیلنج بھیجتا ہے؟

TikTok اپنے API for Business کے لیے کوئی چیلنج دستاویزی نہیں کرتا۔ /business/webhook/update/ کال URL رجسٹر کرتی ہے، اور اس کے بعد ڈیلیوریز Tiktok-Signature کے ساتھ آتی ہیں تاکہ آپ کا سرور انہیں چیک کر سکے۔

میرا TikTok ویب ہک سگنیچر کبھی میچ کیوں نہیں کرتا؟

ان پٹ اور کلید چیک کریں: HMAC کو t، نقطہ اور وصول شدہ خام body پر بننا چاہیے، ایپ سیکرٹ استعمال ہو، اور اسے پورے ہیڈر کے بجائے s= کے بعد کی ویلیو سے موازنہ کیا جائے۔

easyCoexistence کے فارورڈ کیے گئے TikTok ایونٹس کی تصدیق کیسے کریں؟

X-EC-Signature کے ساتھ اور اس سیکرٹ سے جو منزل ترتیب دیتے وقت دکھایا گیا تھا: t، نقطہ اور خام body پر HMAC-SHA256 دوبارہ بنائیں، اسے v1 سے موازنہ کریں، اور 5 منٹ سے پرانے t کو مسترد کریں۔

مزید پڑھیں

TikTok API for Business ویب ہکس کی ترتیبTikTok API for Business ایپ کے ویب ہکس سبسکرائب کرنا: /business/webhook/update/، VIDEO اور COMMENT ایونٹس، کال بیک قواعد اور Tiktok-Signature۔TikTok کمنٹ ویب ہک ایونٹسTikTok کا comment.update ویب ہک کمنٹس اور ریپلائیز کیسے بتاتا ہے، ہر ایونٹ میں کیا ہوتا ہے، اور وہ دستخط شدہ آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں۔API کے ذریعے TikTok Mentions: کسی اکاؤنٹ کا ذکر کرنے والی پوسٹس اور کمنٹس تلاش کرناTikTok کا Mentions API: وہ عوامی پوسٹس اور کمنٹس جو کسی کاروبار کو @ سے ذکر کریں، اس کے اینڈ پوائنٹس، biz.brand.insights اسکوپ، تاخیر اور ویب ہک۔TikTok API ریٹ لمٹس: فی اکاؤنٹ، ایپ اور اینڈ پوائنٹ کے حساب سے درخواستیںTikTok API ریٹ لمٹس: ہر اکاؤنٹ اور اینڈ پوائنٹ پر ایک منٹ میں 40 کالز، Accounts API پر ایپ کی سطح کے مطابق 600 یا 1,000 فی منٹ، اور چار ایپ لیولز۔TikTok API برائے کاروبار کے ایکسیس ٹوکن: 24 گھنٹے، ریفریش اور منسوخیTikTok API برائے کاروبار کے ٹوکن: auth_code کا تبادلہ، 24 گھنٹے کا ایکسیس ٹوکن، ایک سال کا ریفریش ٹوکن، تجدید اور منسوخی۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ