உள்நுழைஇலவசமாகத் தொடங்குங்கள்
easyCoexistence அதிகாரப்பூர்வ API-கள்

வெப்ஹூக்குகளைச் சரிபார்த்தல்: TikTok-இன் கையொப்ப ஹெடரும் அதைச் சரிபார்க்கும் முறையும்

TikTok-இன் API for Business ஒவ்வொரு வெப்ஹூக் டெலிவரியையும் Tiktok-Signature ஹெடரில் கையொப்பமிடுகிறது. அதன் வடிவம் t=<unix seconds>,s=<hex>. இங்கே s என்பது t மதிப்பு, ஒரு புள்ளி, கோரிக்கையின் உள்ளடக்கம் ஆகியவற்றின் HMAC-SHA256; டெவலப்பர் செயலியின் ரகசியத்தால் சாவி இடப்படுகிறது. ஒன்றைச் சரிபார்க்க, பெறப்பட்ட மூல உள்ளடக்கத்தின் மீது அந்த HMAC-ஐ மீண்டும் கணக்கிட்டு, 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

மென்ஷன் வெப்ஹூக்குகளுக்கான நிகழ்வு வகை; அதன் சந்தா வழிகாட்டி அதே கையொப்பச் சரிபார்ப்பைச் சுட்டுகிறது.

v1

easyCoexistence-இன் X-EC-Signature ஹெடரின் கையொப்பப் பகுதி: t-இன் 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 மதிப்பு ஒரு சரமாக, ஒரு புள்ளி, பிறகு உள்ளடக்கம். TikTok-இன் வழிகாட்டி அந்தக் கடைசிப் பகுதியை கோரிக்கை உள்ளடக்கத்தின் சரமாக்கப்பட்ட JSON நகல் என்று அழைக்கிறது; அதன் Node மாதிரி, ஏற்கெனவே பாகுபடுத்தப்பட்ட ஒரு பொருளின் மீது JSON.stringify ஐ இயக்கி அந்த நகலை மீண்டும் உருவாக்குகிறது. இரண்டு சீரியலைசர்களும் இடைவெளி, விசைகளின் வரிசை, எஸ்கேப் முறை ஆகியவற்றில் ஒத்துப்போகும்போது மட்டுமே அது 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, சாவி கணக்கின் signing secret:

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-இடம் சிக்கலைப் புகார் செய்தால் கோரிக்கையை அடையாளம் காண இது உதவும். உள்ளடக்கத்தில் உள்ள client_key டெவலப்பர் செயலியைக் குறிக்கிறது; அதை உங்கள் சொந்த app ID உடன் ஒப்பிடுவது ஒரு எளிய இரண்டாம் சரிபார்ப்பு.

callback URL எப்படிப் பதிவு செய்யப்படுகிறது, அது சரிபார்க்கப்படுகிறதா?

ஒரே API அழைப்பின் மூலம்; URL-ஐ முதலில் சோதிக்கும் challenge கோரிக்கை எதையும் TikTok ஆவணப்படுத்தவில்லை. 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 என பதிலளிக்கிறது, வேறு செயலியைக் குறிக்கும் client_key உள்ள உள்ளடக்கத்தைப் புறக்கணிக்கிறது, பின்னர் இணைக்கப்பட்ட அந்தக் கணக்கின் signing secret உடன் உங்களுக்கான முன்னனுப்பலை X-EC-Signature-இல் கையொப்பமிடுகிறது.

easyCoexistence தான் அனுப்பும் பொருளை எப்படிக் கையொப்பமிடுகிறது?

X-EC-Signature ஹெடரில், t=<unix>,v1=<hex>; இங்கே t என்பது முன்னனுப்பும் நேரம், v1 என்பது t, ஒரு புள்ளி, அனுப்பப்பட்டபடியே உள்ள உள்ளடக்கம் ஆகியவற்றின் hex HMAC-SHA256. சாவி கணக்கின் signing secret; அது 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))

signing secret மாற்றப்பட்டால் என்ன நடக்கும்?

அடுத்த முன்னனுப்பல் முதல் புதிய ரகசியம் கையொப்பமிடுகிறது. set_social_webhook_destination அல்லது PUT /channels/{id}/webhook ஐ மீண்டும் அழைத்தால் புதிய ரகசியம் கிடைக்கும், பழையது உடனடியாக நீக்கப்படும்; ஒவ்வொரு முன்னனுப்பலும் ஒரு முறை மட்டுமே அனுப்பப்படுவதால், மாற்றத்தின்போது உங்கள் சர்வர் நிராகரிக்கும் நிகழ்வு இழக்கப்படும். புதிய ரகசியம் பயன்பாட்டுக்கு வரும் சில நிமிடங்களுக்கு இரண்டு ரகசியங்களையும் ஏற்றுக்கொள்ளுங்கள். சேனல்கள், பதிவுகள் பற்றிய நிலை நிகழ்வுகள் வேறொரு ரகசியத்தைப் பயன்படுத்துகின்றன; அது Dashboard, Profile, Developers என்பதிலிருந்து கிடைக்கும்; அவை X-EC-Event, X-EC-Delivery ஹெடர்களுடன் வருகின்றன, சுமார் 33 மணி நேரம் வரை மீண்டும் முயற்சிக்கப்படும்.

பொதுவான தவறுகள்

  • உள்ளடக்கத்தை ஏற்கெனவே பாகுபடுத்திய கட்டமைப்பைச் சரிபார்த்தல். JSON மிடில்வேர் ஒரு பொருளைத் தருகிறது, அதை மீண்டும் serialize செய்வது TikTok-இன் பைட்டுகளை மாற்றக்கூடும்; வெப்ஹூக் ரூட்டில் மூல உள்ளடக்கத்தைப் படியுங்கள்.
  • கையொப்பம் தோல்வியுற்ற டெலிவரிக்கு 200 அளிப்பது. TikTok 200 ஐக் கண்டவுடன் நிகழ்வை அனுப்புவதை நிறுத்துகிறது; தவறாக அமைக்கப்பட்ட சோதனையால் நிராகரிக்கப்பட்ட உண்மையான நிகழ்வு இழக்கப்படும்; 4xx என்றால் TikTok 72 மணி நேரம் வரை மீண்டும் முயற்சிக்கும்.
  • கையொப்பங்களை === ஆல் ஒப்பிடுவது, TikTok-இன் மாதிரி செய்வது போல. timingSafeEqual போன்ற நிலையான நேர ஒப்பீடு, போலிக் கையொப்பத்தில் எவ்வளவு பொருந்தியது என்பதை வெளிப்படுத்தாது.
  • easyCoexistence-இன் ரகசியத்தை Base64 ஆக டிகோட் செய்வது அல்லது அதன் whsec_ முன்னொட்டை வெட்டுவது. 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 challenge அனுப்புமா?

API for Business-க்கு எதையும் TikTok ஆவணப்படுத்தவில்லை. /business/webhook/update/ அழைப்பு URL-ஐப் பதிவு செய்கிறது; அதன் பின் டெலிவரிகள் Tiktok-Signature உடன் வரும், உங்கள் சர்வர் அதைச் சரிபார்க்கலாம்.

என் TikTok வெப்ஹூக் கையொப்பம் ஏன் ஒருபோதும் பொருந்துவதில்லை?

உள்ளீட்டையும் சாவியையும் சரிபாருங்கள்: HMAC, t, ஒரு புள்ளி, வந்தபடியே உள்ள மூல உள்ளடக்கம் ஆகியவற்றை உள்ளடக்க வேண்டும், செயலி ரகசியத்தைப் பயன்படுத்த வேண்டும், மேலும் முழு ஹெடரோடு அல்லாமல், s= க்குப் பின் உள்ள மதிப்போடு ஒப்பிடப்பட வேண்டும்.

easyCoexistence முன்னனுப்பும் TikTok நிகழ்வுகளை நான் எப்படிச் சரிபார்ப்பது?

X-EC-Signature மற்றும் இலக்கை அமைக்கும்போது காட்டப்படும் signing secret உடன்: t, ஒரு புள்ளி, மூல உள்ளடக்கம் ஆகியவற்றின் மீது HMAC-SHA256-ஐ மீண்டும் கணக்கிட்டு, v1 உடன் ஒப்பிட்டு, 5 நிமிடங்களுக்கு மேல் பழைய t-ஐ நிராகரியுங்கள்.

தொடர்ந்து படிக்கவும்

TikTok API for Business வெப்ஹூக்குகளை அமைத்தல்TikTok API for Business ஆப் வெப்ஹூக் சந்தா: /business/webhook/update/, VIDEO, COMMENT நிகழ்வுகள், கால்பேக் விதிகள், Tiktok-Signature.TikTok கருத்து வெப்ஹூக் நிகழ்வுகள்comment.update வெப்ஹூக் கருத்து, பதில் நிகழ்வுகள், அவற்றில் உள்ளவை, உங்கள் எண்ட்பாயிண்டிற்கு கையொப்பத்துடன் வரும் விதம்.API வழியாக TikTok மென்ஷன்கள்: ஒரு கணக்கை மென்ஷன் செய்யும் பதிவுகளையும் கருத்துகளையும் கண்டறிதல்TikTok Mentions API: வணிகத்தை மென்ஷன் செய்யும் பொது பதிவுகள், கருத்துகள், எண்ட்பாயிண்ட்கள், biz.brand.insights ஸ்கோப், தாமதங்கள் மற்றும் வெப்ஹூக்.TikTok API வரம்புகள்: ஒவ்வொரு கணக்கு, ஆப் மற்றும் எண்ட்பாயிண்ட்டுக்கும்TikTok API வரம்புகள்: ஒரு கணக்கிற்கு நிமிடத்திற்கு 40 அழைப்புகள், ஆப்பிற்கு 600 அல்லது 1,000, மற்றும் நான்கு ஆப் நிலைகள்.TikTok API for Business அணுகல் டோக்கன்கள்: 24 மணி நேரம், புதுப்பித்தல் மற்றும் ரத்துTikTok API for Business டோக்கன்கள்: auth_code பரிமாற்றம், 24 மணி நேர access_token, ஓராண்டு refresh_token, புதுப்பித்தல் மற்றும் ரத்து செய்தல்.

உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.

காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.

  • 3 நாட்கள் இலவசம்
  • எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
  • அதிகாரப்பூர்வ API-கள் மட்டுமே
  • 24/7 கண்காணிப்பு

இதில் சரிபார்க்கப்பட்டது: