TikTok API for Business வெப்ஹூக்குகளை அமைத்தல்
TikTok API for Business ஒவ்வொரு டெவலப்பர் ஆப்புக்கும் மற்றும் நிகழ்வு வகைக்கும் ஒரு கால்பேக் URL-க்கு வெப்ஹூக்குகளை அனுப்புகிறது; அதை ஆப்பின் app_id மற்றும் secret உடன் POST /business/webhook/update/ மூலம் அமைக்கலாம். event_type VIDEO நான்கு போஸ்ட் வெளியீட்டு நிகழ்வுகளுக்கும், COMMENT comment.update-க்கும் சந்தா செய்கிறது. ஒவ்வொரு டெலிவரியும் HTTPS POST ஆகும், அது ஆப் ரகசியத்தை சாவியாகக் கொண்ட HMAC-SHA256 மூலம் Tiktok-Signature தலைப்பில் கையொப்பமிடப்படுகிறது.
easyCoexistence உங்கள் கணக்குக்கான TikTok கமென்ட் வெப்ஹூக்கை ஆப்புக்காக சந்தா செய்து வைக்கிறது, TikTok-இன் கையொப்பத்தைச் சரிபார்க்கிறது, உங்கள் கணக்குக்கான ஒவ்வொரு கமென்ட் நிகழ்வையும் உங்கள் HTTPS எண்ட்பாயிண்டிற்கு அனுப்புகிறது; அது அதன் சொந்த ரகசியத்தால் கையொப்பமிடப்படுகிறது.
HTTP 200 பதில் பெறாத டெலிவரியை TikTok அதிவேக இடைவெளியில் எவ்வளவு நேரம் மீண்டும் முயற்சிக்கும், பின்னர் நிராகரிக்கும் என்பது.
ஒரு item_list அதிகபட்சம் எத்தனை போஸ்ட் ID-களைக் குறிப்பிட முடியும் என்பது, comment.update நிகழ்வுகளை குறிப்பிட்ட போஸ்ட்களுக்கு மட்டும் குறைக்க.
TikTok ஒவ்வொரு டெலிவரியுடனும் அனுப்பும் webhook-schema-version தலைப்பின் தற்போதைய மதிப்பு.
வெப்ஹூக் கட்டமைப்பு எண்ட்பாயிண்ட்களுக்காக TikTok குறிப்பு ஆவணம் பட்டியலிடுவது, இவை app ID மற்றும் secret மூலம் அங்கீகரிக்கின்றன.
Tiktok-Signature-இன் அல்காரிதம்: நேர முத்திரை, ஒரு புள்ளி, பின்னர் உடல், ஆப் ரகசியத்தை சாவியாகக் கொண்டு, hex-encoded.
comment.update-க்குத் தேவையான, TikTok Accounts-இன் கீழ் உள்ள ஆப் அனுமதி; வெளியீட்டு நிகழ்வுகளுக்கு Business Content தேவை.
TikTok கணக்கு ஆப் எந்த வெப்ஹூக் நிகழ்வுகளைப் பெற முடியும்?
இரண்டு வகைகள், ஒவ்வொன்றும் தனி event_type ஆக சந்தா செய்யப்படுகின்றன. VIDEO என்பது /business/video/publish/ அல்லது /business/photo/publish/ மூலம் வெளியிடப்படும் போஸ்ட்களை உள்ளடக்கும்; COMMENT என்பது கணக்கின் புகைப்படப் போஸ்ட்கள் மற்றும் பொது வீடியோ போஸ்ட்களில் உள்ள கமென்ட்களை உள்ளடக்கும், அவை API மூலம் வெளியிடப்பட்டவையாயினும் TikTok ஆப்பில் வெளியிடப்பட்டவையாயினும்:
சந்தா செய்வதற்கு முன் ஆப்புக்கு என்ன தேவை?
API for Business-க்கான அணுகல், ஒரு டெவலப்பர் ஆப், அதை அங்கீகரித்த TikTok கணக்குகள். TikTok-இன் சந்தா வழிகாட்டி ஒவ்வொரு வகைக்கும் ஒரு அனுமதியைச் சேர்க்கிறது, கமென்ட் நிகழ்வுக்கு ஒவ்வொரு உரிமையாளரிடமிருந்தும் ஒரு ஸ்கோப் தேவை:
- வெளியீட்டு நிகழ்வுகள்: ஆப்பில் TikTok Accounts, Business Content அனுமதி.
- கமென்ட் நிகழ்வுகள்: ஆப்பில் TikTok Accounts, Business Comment அனுமதி.
- comment.update: comment.list ஸ்கோப், உரிமையாளர் வழங்கி, செல்லுபடியாக வைத்திருக்கப்பட வேண்டும்.
- HTTPS-இல் ஒரு கால்பேக் URL, அது உடனே HTTP 200 பதிலளிக்க வேண்டும்.
சந்தா செய்வது எப்படி?
/business/webhook/update/ க்கு POST அனுப்பி, ஒவ்வொரு event_type-க்கும் ஒரு முறை. உடலில் app_id மற்றும் secret, event_type (VIDEO அல்லது COMMENT), callback_url ஆகியவை; COMMENT-க்கு item_list-உம் அனுப்பலாம். பதிலில் app_id, event_type, callback_url மற்றும் கட்டமைக்கப்பட்டிருந்தால் item_list திரும்பும். அதே event_type-க்கு மீண்டும் அழைத்தால் callback URL மாற்றப்படும்.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/webhook/update/' \
-H 'Content-Type: application/json' \
-d '{
"app_id": "<APP_ID>",
"secret": "<APP_SECRET>",
"event_type": "COMMENT",
"callback_url": "https://hooks.example.com/tiktok/"
}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": { "app_id": "<APP_ID>", "callback_url": "https://hooks.example.com/tiktok/", "event_type": "COMMENT" }
}item_list கமென்ட் நிகழ்வுகளை எவ்வாறு குறைக்கிறது?
இது comment.update-ஐ அது குறிப்பிடும் போஸ்ட்களுக்கு மட்டும் வரம்பிடுகிறது, /business/video/list/ இலிருந்து 100 ID வரை; முதல் பட்டியல் அன்றிலிருந்து ஆப்புக்கான பயன்முறையை முடிவு செய்கிறது:
item_listஉடன் முதல் COMMENT அழைப்பு: குறிப்பிடப்பட்ட போஸ்ட்களுக்கு மட்டும் நிகழ்வுகள் வரும்.item_listஉடன் பின்னர் வரும் அழைப்புகள்: புதிய போஸ்ட்கள் ஏற்கனவே உள்ள பட்டியலில் சேரும்.item_listஇல்லாத COMMENT அழைப்பு, முன்பு எதுவும் அமைக்கப்படவில்லை என்றால்: ஆப்பை அங்கீகரித்த கணக்குகளின் போஸ்ட்களுக்கான நிகழ்வுகள் வரும்.item_listஇல்லாத COMMENT அழைப்பு, பட்டியல் ஏற்கனவே இருந்தால்: கட்டமைக்கப்பட்ட போஸ்ட்கள் அப்படியே இருக்கும்.
சந்தாவைச் சரிபார்ப்பது அல்லது நீக்குவது எப்படி?
app_id, secret, event_type உடன் GET /business/webhook/list/ கட்டமைப்பைத் திருப்பும்: callback_url அந்த event type-க்கு ஒன்று இருந்தால் மட்டும் தோன்றும், item_list அமைக்கப்பட்டிருந்தால் மட்டும். app_id, secret, event_type உடன் POST /business/webhook/delete/ அதை நீக்கும்; COMMENT-க்கு, நீக்கும் அழைப்பில் item_list இருந்தால் அந்தப் போஸ்ட்கள் மட்டும் நீக்கப்படும், இல்லையெனில் எல்லா போஸ்ட்களுக்கும் கமென்ட் நிகழ்வுகள் நின்றுவிடும்.
கால்பேக் URL என்ன செய்ய வேண்டும்?
உடனே பதிலளிக்க வேண்டும். TikTok HTTPS வழியாக JSON-ஐ POST செய்கிறது, HTTP 200 அல்லாத எதையும் தோல்வியுற்ற டெலிவரியாகக் கருதுகிறது, நிகழ்வை நிராகரிக்கும் முன் அதிவேக இடைவெளியுடன் 72 மணி நேரம் வரை மீண்டும் முயற்சிக்கிறது. டெலிவரி குறைந்தது ஒரு முறையாவது நடக்கும், எனவே அதே நிகழ்வு இரண்டு முறை வரலாம்; செயலாக்கம் மீண்டும் இயக்கப்பட்டாலும் ஒரே முடிவைத் தர வேண்டும். ஒவ்வொரு கோரிக்கையிலும் பதிவு செய்யத் தகுந்த மூன்று தலைப்புகள் உள்ளன: tiktok-signature, webhook-schema-version மற்றும் x-tt-logid; உடலில் client_key, event, create_time (வினாடிகளில்), user_openid (அது கணக்கின் business_id), மற்றும் content (தொடராக்கப்பட்ட JSON சரம்) ஆகியவை உள்ளன.
Tiktok-Signature-ஐ எவ்வாறு சரிபார்ப்பது?
தலைப்பை காற்புள்ளிகளில் பிரித்து, பின் சம அடையாளத்தில்: t=<unix>,s=<hex>. t மதிப்பிலிருந்து, ஒரு புள்ளியிலிருந்து, கோரிக்கை உடலிலிருந்து கையொப்பமிடப்பட்ட செய்தியை உருவாக்கவும்; அதன் HMAC-SHA256-ஐ ஆப் ரகசியத்தை சாவியாகக் கொண்டு கணக்கிட்டு, hex-ஆக குறியாக்கி, s உடன் ஒப்பிடவும். பின்னர் t எவ்வளவு பழையது என்று சரிபார்க்கவும்: மறுஇயக்கத் தாக்குதல்களைத் தடுக்க TikTok டெலிவரி நேரத்தில் கையொப்பமிடுகிறது, அதன் மாதிரி 5 வினாடி தாமதத்தை ஏற்கிறது. பெறப்பட்ட மூல உடலிலிருந்தே வேலை செய்வது JSON-ஐ வேறு விதமாக மறுபடி தொடராக்குவதைத் தவிர்க்கிறது.
import hashlib, hmac, time
def verify_tiktok(raw_body: bytes, header: str, app_secret: str, max_age: int = 300) -> bool:
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, s = parts.get("t", ""), parts.get("s", "")
if not t.isdigit():
return False
expected = hmac.new(app_secret.encode(), t.encode() + b"." + raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, s) and abs(time.time() - int(t)) <= max_ageeasyCoexistence வழியாக TikTok நிகழ்வுகளை எவ்வாறு பெறுவது?
கணக்குக்கு ஒரு இலக்கு கொடுப்பதன் மூலம். easyCoexistence தனது சொந்த ஆப்பை COMMENT-க்கு சந்தா செய்து வைத்திருக்கிறது, TikTok-இன் கையொப்பத்தைச் சரிபார்க்கிறது, TikTok-க்கு உடனே பதிலளிக்கிறது, இணைக்கப்பட்ட கணக்குக்கான ஒவ்வொரு comment.update-ஐயும் அதற்காக அமைக்கப்பட்ட HTTPS எண்ட்பாயிண்டிற்கு POST செய்கிறது. Claude அல்லது ChatGPT-இலிருந்து, set_social_webhook_destination account_id மற்றும் url எடுக்கும், நிறுத்த null; அது ஒருமுறை மட்டுமே காட்டப்படும் கையொப்ப ரகசியத்தைத் திருப்பும்; மீண்டும் அழைத்தால் புதியது வழங்கப்படும். வெளியீட்டு நிகழ்வுகள் அனுப்பப்படுவதில்லை: அதற்குப் பதில் get_tiktok_publish_status ஒரு போஸ்ட்டைக் கண்காணிக்கும்.
set_social_webhook_destination { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/tiktok/" }
=> {
"url": "https://hooks.example.com/tiktok/",
"signing_secret": "whsec_<SECRET>",
"note": "Shown once: store it as a secret. ..."
}Partner API மூலம் இதை எவ்வாறு அமைப்பது?
https://easycoexistence.com/api/v1 இல் PUT /channels/{id}/webhook, உங்கள் ec_live_ கீ ஐ bearer டோக்கனாகவும், {"url": "https://..."} உடலாகவும். பதிலில் webhook_url, signing_secret, note உள்ளன; {"url": null} அனுப்புதலை நிறுத்தும். URL பொது host-இல் HTTPS பயன்படுத்த வேண்டும்; தெரியாத சேனல் 404 not_found, நீக்கப்பட்ட ஒன்று 409 removed, இடைநிறுத்தப்பட்ட ஒன்று 402 suspended ஐத் திருப்பும்.
curl -X PUT "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/webhook" \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://hooks.example.com/tiktok/"}'
{ "webhook_url": "https://hooks.example.com/tiktok/", "signing_secret": "whsec_<SECRET>", "note": "..." }இரண்டு டெலிவரிகளும் எவ்வாறு வேறுபடுகின்றன?
easyCoexistence-இலிருந்து அனுப்பப்படும் ஃபார்வர்ட், TikTok-இன் சொந்த டெலிவரியிலிருந்து வேறுவிதமாக கையொப்பமிடப்பட்டு வடிவமைக்கப்படுகிறது; எனவே ஒன்றுக்காக எழுதப்பட்ட ரிசீவருக்கு மற்றதற்கு மாற்றங்கள் தேவை. ஃபார்வர்ட் செய்யப்பட்ட பேலோட் TikTok-இன் கமென்ட் புலங்களைத் தக்கவைக்கிறது, content பகுப்பாய்வு செய்யப்பட்டு அதன் ID-கள் சரங்களாக; மாறுவது ஒவ்வொரு டெலிவரி எவ்வாறு கையொப்பமிடப்படுகிறது, எவ்வளவு வரம்பிடப்படுகிறது, மீண்டும் முயற்சிக்கப்படுகிறது என்பதுதான்:
| TikTok to your app | easyCoexistence to your endpoint | |
|---|---|---|
| Header | Tiktok-Signature: t=<unix>,s=<hex> | X-EC-Signature: t=<unix>,v1=<hex> |
| Key | The developer app's secret | The account's signing secret, shown once |
| Events | VIDEO and COMMENT, per app | comment.update, per connected account |
| Body | client_key, event, create_time, user_openid, content as a string | platform, account_id, external_id, entry with content parsed |
| Retries | Up to 72 hours | None: one attempt, 8 seconds, no redirects |
இதை எப்படி அமைப்பது
- Grant the permissionsGive the developer app Business Content for publishing events and Business Comment for comment events, and have owners grant comment.list.
- Build the callbackServe an HTTPS endpoint that checks Tiktok-Signature and replies 200 before doing any work.
- Subscribe each event typeCall /business/webhook/update/ with app_id, secret, event_type and callback_url, once for VIDEO and once for COMMENT.
- Confirm the configurationCall /business/webhook/list/ for each event_type and check that the callback_url, and any item_list, came back.
- Handle repeatsKey each event on its content, such as comment_id with comment_action, or publish_id with the event name, before acting on it.
பொதுவான தவறுகள்
- பதிலளிப்பதற்கு முன் நிகழ்வைச் செயலாக்குதல். TikTok உடனடி 200 கேட்கிறது, ஒப்புகை காணாத டெலிவரிகளை மீண்டும் முயற்சிக்கிறது, எனவே வேலையை வரிசையில் வைத்து முதலில் பதிலளிக்கவும்.
- தற்செயலாக முதல் COMMENT சந்தாவில் item_list அனுப்புவது. அதன் பிறகு, குறிப்பிடப்பட்ட போஸ்ட்களுக்கு மட்டும் TikTok கமென்ட் நிகழ்வுகளைத் தெரிவிக்கும்.
- அணுகல் டோக்கனைக் கொண்டு சரிபார்ப்பது. TikTok வெப்ஹூக்குகளை ஆப் ரகசியத்தால் கையொப்பமிடுகிறது, அதுவே /business/webhook/update/ எடுப்பதும்.
- இரண்டு சூழல்களை ஒரே ஆப்புக்குச் சுட்டிக்காட்டுவது. ஒவ்வொரு நிகழ்வு வகைக்கும் ஆப்புக்கு ஒரு callback_url மட்டுமே உண்டு, புதிய /business/webhook/update/ அழைப்பு அதை மாற்றும்.
Claude அல்லது ChatGPT-இலிருந்து set_social_webhook_destination மூலமோ, அல்லது PUT /channels/{id}/webhook மூலமோ அமைக்கவும். இணைப்பு ஒன்றுக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, நீங்கள் இணைப்புகளைச் சேர்க்கச் சேர்க்கக் குறையும், முதல் 7 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
TikTok வெப்ஹூக் டெலிவரியில் எந்த தலைப்புகள் வருகின்றன?
tiktok-signature, webhook-schema-version (தற்போது v1.0), மற்றும் x-tt-logid, அதாவது டெலிவரியின் ID. JSON உடலில் client_key, event, create_time, user_openid மற்றும் content உள்ளன.
வீடியோ வெளியிடப்படும்போது TikTok வெப்ஹூக் அனுப்புமா?
ஆம், event_type VIDEO உடன்: கோப்பை TikTok பதிவிறக்கி சரிபார்த்த பின் post.publish.complete, பின்னர் போஸ்ட் பொதுவில் வந்ததும் post_id உடன் post.publish.publicly_available.
TikTok தோல்வியடைந்த வெப்ஹூக்கை எவ்வளவு நேரம் மீண்டும் முயற்சிக்கும்?
அதிவேக இடைவெளியுடன் 72 மணி நேரம் வரை, அதன் பின் நிகழ்வு நிராகரிக்கப்படும். டெலிவரி குறைந்தது ஒரு முறையாவது நடக்கும், எனவே நகல்களை எதிர்பார்க்கவும்.
easyCoexistence-இன் TikTok ஆப்பில் என் சொந்த கால்பேக்கைப் பதிவு செய்ய முடியுமா?
முடியாது. ஆப்பின் வெப்ஹூக் அமைப்புகள் easyCoexistence-இடமே இருக்கும். set_social_webhook_destination கணக்கின் கமென்ட் நிகழ்வுகளை அதற்குப் பதில் உங்களுக்கு அனுப்பும்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: