أمثلة عملية لـ TikTok API في Python وNode.js
تعمل واجهة برمجة التطبيقات (API) الخاصة بـ TikTok for Business من Python أو Node.js عبر طلبات HTTPS عادية: أرسل كل استدعاء إلى https://business-api.tiktok.com/open_api/v1.3 مع رمز الوصول (token) الخاص بالحساب في الترويسة Access-Token، وأرسل open_id الخاص بالحساب بوصفه business_id. ترد TikTok على معظم الاستدعاءات برمز HTTP 200 وحقل code، وقيمته 0 عند النجاح، فتحقّق منه، وإن ظهر الرمز 40100 فانتظر 5 دقائق.
يمنح easyCoexistence كلاً من Claude وChatGPT وكودك الخاص المهام نفسها بوصفها أدوات، من publish_tiktok_post وreply_to_comment إلى get_social_insights، ويسلّم سكربتاتك رمزاً محدّثاً عبر get_social_credentials أو Partner API.
حالة معظم استجابات TikTok، بما فيها الأخطاء؛ ولا يدل على نجاح الاستدعاء إلا القيمة 0 في حقل code داخل النص.
رمز الاستدعاء عند تجاوز الحد: تطلب TikTok وقفة مدتها 5 دقائق بعد تجاوز حد الدقيقة، وحتى 00:00 UTC بعد تجاوز الحد اليومي.
أخطاء الخادم، وتقترح TikTok بعدها الانتظار نحو 5 دقائق قبل إعادة الاستدعاء.
تنتهي المسارات بشرطة مائلة /، وتذكر TikTok أن /tt_user/oauth2/refresh_token بدونها سبب لخطأ 404 page not found.
تتوفر حزمة SDK الخاصة بـ TikTok API for Business بلغات Python وJavaScript وJava، ولا تتضمن قائمة نقاط النهاية (endpoint) فيها أي مسار /business/.
التوقيع في ترويسة Tiktok-Signature لكل خطاف ويب (webhook)، ويُحسب على الطابع الزمني ثم نقطة ثم نص الطلب، بمفتاح سر التطبيق.
ما الذي يحتاجه كل استدعاء لواجهة TikTok API؟
الأشياء الخمسة نفسها، مهما كانت المهمة:
- عنوان القاعدة https://business-api.tiktok.com/
open_api/v1.3، مع مسار ينتهي بشرطة مائلة، مثل /business/video/list/. - رمز الوصول الخاص بالحساب في الترويسة Access-Token، ويُجدَّد قبل انتهاء صلاحيته التي تبلغ 24 ساعة.
business_id، وهوopen_idالخاص بالحساب: في سلسلة الاستعلام عند GET، وفي نص JSON عند POST.- معاملات القوائم والكائنات عند GET، مثل fields وfilters، مرسلة كنص JSON: fields=["
item_id","caption"]. - فحص code في الاستجابة، لأن TikTok ترسل أخطاء مثل 40002 أو 40100 برمز HTTP 200، ولا تحمل البيانات إلا عندما تكون code هي 0.
كيف تتعامل مع غلاف الأخطاء في TikTok بلغة Python؟
بعميل صغير يضع business_id حيث تتوقعه كل دالة، ويعيد data عندما تكون code هي 0، ويرفع TikTokError في غير ذلك. يعيد الاستدعاء المقيَّد بعد وقفة TikTok البالغة 5 دقائق، لأن 40100 تعني أن TikTok رفضت الاستدعاء، ويعيد خطأ 5xx على GET فقط، لأن النشر الذي انتهى بخطأ خادم قد يكون وصل إلى TikTok. يحتاج مكتبة requests، وتعيد الأمثلة اللاحقة استخدامه:
import json
import os
import time
import requests
API = "https://business-api.tiktok.com/open_api/v1.3"
class TikTokError(Exception):
def __init__(self, code, message, request_id):
super().__init__(f"TikTok {code}: {message} (request_id {request_id})")
self.code = code
class TikTok:
"""One TikTok account: its access token and its business_id, the open_id."""
def __init__(self, access_token, business_id, pause=300):
self.http = requests.Session()
self.http.headers["Access-Token"] = access_token
self.business_id = business_id
self.pause = pause # TikTok's advice after a 40100 or a 5xx: about 5 minutes
def call(self, method, path, params=None, body=None, tries=3):
for attempt in range(1, tries + 1):
if method == "GET":
query = {"business_id": self.business_id}
for key, value in (params or {}).items():
is_json = isinstance(value, (list, dict))
query[key] = json.dumps(value, separators=(",", ":")) if is_json else value
res = self.http.get(f"{API}/{path}", params=query, timeout=30)
else:
payload = {"business_id": self.business_id, **(body or {})}
res = self.http.post(f"{API}/{path}", json=payload, timeout=30)
if res.status_code >= 500 and method == "GET" and attempt < tries:
time.sleep(self.pause) # a POST is not repeated: it may have reached TikTok
continue
res.raise_for_status() # a 4xx: a wrong path or method, such as a missing final slash
answer = res.json()
if answer.get("code") == 0:
return answer.get("data") or {}
if answer.get("code") == 40100 and attempt < tries:
time.sleep(self.pause) # throttled: TikTok refused the call, so repeating it is safe
continue
raise TikTokError(answer.get("code"), answer.get("message"), answer.get("request_id"))
tt = TikTok(os.environ["TIKTOK_ACCESS_TOKEN"], os.environ["TIKTOK_BUSINESS_ID"])كيف تتعامل معه في Node.js؟
العميل نفسه فوق fetch المدمجة في Node.js 18 والإصدارات الأحدث، دون تثبيت أي شيء. يرمّز معاملات القوائم كنص JSON في GET، ويضع business_id في النص عند POST، ويحتفظ برمز code من TikTok في الخطأ، فيستطيع المستدعي التمييز بين 40102 أو 40105، وهي مشكلة في الرمز، و40001، وهي صلاحية مفقودة:
const API = "https://business-api.tiktok.com/open_api/v1.3";
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
class TikTokError extends Error {
constructor(code, message, requestId) {
super("TikTok " + code + ": " + message + " (request_id " + requestId + ")");
this.code = code;
}
}
// One TikTok account: its access token and its business_id, the open_id.
class TikTok {
constructor(accessToken, businessId, pauseMs = 300000) {
this.accessToken = accessToken;
this.businessId = businessId;
this.pauseMs = pauseMs; // TikTok's advice after a 40100 or a 5xx: about 5 minutes
}
async call(method, path, { params = {}, body = {} } = {}, tries = 3) {
for (let attempt = 1; ; attempt++) {
const url = new URL(API + "/" + path);
const init = { method, headers: { "Access-Token": this.accessToken } };
if (method === "GET") {
url.searchParams.set("business_id", this.businessId);
for (const [key, value] of Object.entries(params)) {
url.searchParams.set(key, typeof value === "object" ? JSON.stringify(value) : String(value));
}
} else {
init.headers["Content-Type"] = "application/json";
init.body = JSON.stringify({ business_id: this.businessId, ...body });
}
const res = await fetch(url, init);
if (res.status >= 500 && method === "GET" && attempt < tries) {
await sleep(this.pauseMs); // a POST is not repeated: it may have reached TikTok
continue;
}
if (!res.ok) throw new Error("HTTP " + res.status + " on " + path + ": check the path, its final slash and the method");
const answer = await res.json();
if (answer.code === 0) return answer.data ?? {};
if (answer.code === 40100 && attempt < tries) {
await sleep(this.pauseMs); // throttled: TikTok refused the call, so repeating it is safe
continue;
}
throw new TikTokError(answer.code, answer.message, answer.request_id);
}
}
}
const tt = new TikTok(process.env.TIKTOK_ACCESS_TOKEN, process.env.TIKTOK_BUSINESS_ID);كيف تنشر فيديو عبر رابط وتتحقق من حالته؟
أرسل POST إلى /business/video/publish/ مع video_url وpost_info، ثم تستعلم بشكل متكرر عن /business/publish/status/ باستخدام share_id بوصفه publish_id. تتوقف الحلقة عند FAILED مع سبب TikTok، وعند PUBLISH_COMPLETE تستمر في الانتظار حتى يصل post_ids، وتقول TikTok إن ذلك قد يستغرق ثلاث دقائق إضافية. يجب أن يكون video_url داخل نطاق أو بادئة URL موثّقة لتطبيقك:
# Python
def wait_until_live(tt, share_id, interval=30, give_up_after=7200):
deadline = time.time() + give_up_after
while time.time() < deadline:
status = tt.call("GET", "business/publish/status/", params={"publish_id": share_id})
if status["status"] == "FAILED":
raise RuntimeError(f"TikTok did not publish {share_id}: {status.get('reason')}")
if status["status"] == "PUBLISH_COMPLETE" and status.get("post_ids"):
return status["post_ids"]
time.sleep(interval) # post_ids can follow PUBLISH_COMPLETE by up to three minutes
raise TimeoutError(f"{share_id} was not public after {give_up_after} s")
video = tt.call("POST", "business/video/publish/", body={
"video_url": "https://media.example.com/tiktok/launch.mp4", # on a verified domain or URL prefix
"post_info": {
"caption": "Our spring menu is live #food",
"is_brand_organic": True, # the Promotional content label, for the account's own business
"is_branded_content": False,
},
})
print("Live:", wait_until_live(tt, video["share_id"]))
// Node.js
async function waitUntilLive(tt, shareId, everyMs = 30000, giveUpAfterMs = 7200000) {
const deadline = Date.now() + giveUpAfterMs;
while (Date.now() < deadline) {
const s = await tt.call("GET", "business/publish/status/", { params: { publish_id: shareId } });
if (s.status === "FAILED") throw new Error("TikTok did not publish " + shareId + ": " + s.reason);
if (s.status === "PUBLISH_COMPLETE" && s.post_ids && s.post_ids.length) return s.post_ids;
await sleep(everyMs); // post_ids can follow PUBLISH_COMPLETE by up to three minutes
}
throw new Error(shareId + " was not public after " + giveUpAfterMs / 1000 + " s");
}
async function publishVideo(tt) {
const video = await tt.call("POST", "business/video/publish/", {
body: {
video_url: "https://media.example.com/tiktok/launch.mp4", // on a verified domain or URL prefix
post_info: { caption: "Our spring menu is live #food", is_brand_organic: true, is_branded_content: false },
},
});
return waitUntilLive(tt, video.share_id);
}
publishVideo(tt).then((postIds) => console.log("Live:", postIds), console.error);كيف تنشر الصور؟
اقرأ الإعدادات المسموح بها للحساب أولاً، ثم أرسل POST إلى /business/photo/publish/. يتطلب نشر الصورة privacy_level، ويجب أن تكون قيمته إحدى privacy_level_options الواردة من /business/video/settings/. وإذا كانت comment_disabled تساوي true هناك، فيجب أن تساوي disable_comment القيمة true أيضاً. يُتابَع share_id المُعاد بدالة الانتظار نفسها المستخدمة للفيديو:
# Python
def publish_photos(tt, image_urls, title, caption):
settings = tt.call("GET", "business/video/settings/")
if "PUBLIC_TO_EVERYONE" not in settings["privacy_level_options"]:
raise RuntimeError(f"Private account, choose from {settings['privacy_level_options']}")
photo = tt.call("POST", "business/photo/publish/", body={
"photo_images": image_urls, # 1 to 35 JPG, JPEG or WebP links on a verified domain or prefix
"photo_cover_index": 0,
"post_info": {
"title": title, # up to 90 UTF-16 code units
"caption": caption, # up to 4,000
"privacy_level": "PUBLIC_TO_EVERYONE",
"disable_comment": settings["comment_disabled"], # True when the account takes no comments
"is_brand_organic": True,
"is_branded_content": False,
},
})
return wait_until_live(tt, photo["share_id"])
print(publish_photos(tt, ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"],
"Spring menu", "Four new dishes, from Friday #food"))
// Node.js
async function publishPhotos(tt, imageUrls, title, caption) {
const settings = await tt.call("GET", "business/video/settings/");
if (!settings.privacy_level_options.includes("PUBLIC_TO_EVERYONE")) {
throw new Error("Private account, choose from " + settings.privacy_level_options.join(", "));
}
const photo = await tt.call("POST", "business/photo/publish/", {
body: {
photo_images: imageUrls, // 1 to 35 JPG, JPEG or WebP links on a verified domain or prefix
photo_cover_index: 0,
post_info: {
title, // up to 90 UTF-16 code units
caption, // up to 4,000
privacy_level: "PUBLIC_TO_EVERYONE",
disable_comment: settings.comment_disabled, // true when the account takes no comments
is_brand_organic: true,
is_branded_content: false,
},
},
});
return waitUntilLive(tt, photo.share_id);
}
publishPhotos(tt, ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"],
"Spring menu", "Four new dishes, from Friday #food").then(console.log, console.error);كيف تسرد فيديوهات الحساب؟
أرسل GET إلى /business/video/list/ مع الحقول المطلوبة، ومنها item_id، وحتى 20 منشوراً في الصفحة من الأحدث. مرر cursor المُعاد، وهو طابع زمني بالمللي ثانية بتوقيت UTC، ما دامت has_more تساوي true، وتوقع صفحات قصيرة: فقد تعيد قواعد الثقة والسلامة في TikTok أقل من max_count قبل أن تنتهي القائمة.
# Python
def recent_videos(tt, how_many=60):
params = {"fields": ["item_id", "create_time", "caption", "share_url", "video_views", "likes", "comments"],
"max_count": 20}
videos = []
while len(videos) < how_many:
page = tt.call("GET", "business/video/list/", params=params)
videos += page.get("videos", [])
if not page.get("has_more"):
break
params["cursor"] = page["cursor"] # posts published before this UTC time, in milliseconds
return videos[:how_many]
for v in recent_videos(tt):
print(v["item_id"], v.get("video_views"), (v.get("caption") or "")[:60])
// Node.js
async function recentVideos(tt, howMany = 60) {
const params = {
fields: ["item_id", "create_time", "caption", "share_url", "video_views", "likes", "comments"],
max_count: 20,
};
const videos = [];
while (videos.length < howMany) {
const page = await tt.call("GET", "business/video/list/", { params });
videos.push(...(page.videos ?? []));
if (!page.has_more) break;
params.cursor = page.cursor; // posts published before this UTC time, in milliseconds
}
return videos.slice(0, howMany);
}
recentVideos(tt).then((videos) => {
for (const v of videos) console.log(v.item_id, v.video_views, (v.caption || "").slice(0, 60));
}, console.error);كيف تقرأ التعليقات وترد عليها؟
يعيد GET إلى /business/comment/list/ مع item_id المنشور بوصفه video_id حتى 30 تعليقاً في الصفحة، ويرد POST إلى /business/comment/reply/create/ على تعليق واحد علناً بنص يصل إلى 1,200 حرف. يرد المثال على التعليقات العامة ذات المستوى الأعلى التي لا ردود عليها بعد، ويتجاوز تعليقات الحساب نفسه، ويترك الصياغة لدالة تكتبها أنت، لأن TikTok قد تخفي التعليقات المتشابهة إلى حد كبير إذا نُشرت متقاربة في الوقت بوصفها رسائل مزعجة:
# Python
def reply_to_new_comments(tt, video_id, write_reply):
page = tt.call("GET", "business/comment/list/", params={
"video_id": video_id, # the post's item_id
"status": "PUBLIC",
"sort_field": "create_time",
"sort_order": "desc",
"max_count": 30,
})
for comment in page.get("comments", []):
if comment.get("owner") or comment.get("replies") or comment.get("parent_comment_id"):
continue # the account's own comments, threads with replies, and replies
text = write_reply(comment)
if text:
tt.call("POST", "business/comment/reply/create/", body={
"video_id": video_id, "comment_id": comment["comment_id"], "text": text, # up to 1,200 characters
})
def reply_for(comment):
if "price" in (comment.get("text") or "").lower():
return f"Hi {comment.get('display_name') or 'there'}, the price list is pinned on our profile."
return None # leave the rest to a person
reply_to_new_comments(tt, "<ITEM_ID>", reply_for)
// Node.js
async function replyToNewComments(tt, videoId, writeReply) {
const page = await tt.call("GET", "business/comment/list/", {
params: { video_id: videoId, status: "PUBLIC", sort_field: "create_time", sort_order: "desc", max_count: 30 },
});
for (const comment of page.comments ?? []) {
if (comment.owner || comment.replies || comment.parent_comment_id) continue; // own, already replied to, or a reply
const text = writeReply(comment);
if (text) {
await tt.call("POST", "business/comment/reply/create/", {
body: { video_id: videoId, comment_id: comment.comment_id, text }, // up to 1,200 characters
});
}
}
}
function replyFor(comment) {
if ((comment.text || "").toLowerCase().includes("price")) {
return "Hi " + (comment.display_name || "there") + ", the price list is pinned on our profile.";
}
return null; // leave the rest to a person
}
replyToNewComments(tt, "<ITEM_ID>", replyFor).catch(console.error);كيف تقرأ تحليلات الحساب؟
يعيد GET إلى /business/get/ مع أسماء الحقول في fields ونطاق تاريخ UTC يصل إلى 60 يوماً. يرد followers_count مرتين: الإجمالي الحالي في أعلى data، والإجمالي لكل يوم داخل metrics، إلى جانب video_views وprofile_views وlikes وcomments وshares لذلك اليوم. ينتهي النطاق في المثال عند أمس، لأن الأعداد اليومية تصل متأخرة من 24 إلى 48 ساعة:
# Python
from datetime import datetime, timedelta, timezone
def daily_insights(tt, days=7):
yesterday = datetime.now(timezone.utc).date() - timedelta(days=1) # counts arrive 24 to 48 h late
data = tt.call("GET", "business/get/", params={
"fields": ["followers_count", "video_views", "profile_views", "likes", "comments", "shares"],
"start_date": (yesterday - timedelta(days=days - 1)).isoformat(), # UTC, up to 60 days back
"end_date": yesterday.isoformat(),
})
print("Followers now:", data.get("followers_count"))
for day in data.get("metrics", []):
print(day["date"], day.get("followers_count"), day.get("video_views"), day.get("likes"))
daily_insights(tt)
// Node.js
async function dailyInsights(tt, days = 7) {
const utcDay = (daysAgo) => new Date(Date.now() - daysAgo * 86400000).toISOString().slice(0, 10);
const data = await tt.call("GET", "business/get/", {
params: {
fields: ["followers_count", "video_views", "profile_views", "likes", "comments", "shares"],
start_date: utcDay(days), // UTC, up to 60 days back
end_date: utcDay(1), // counts arrive 24 to 48 h late
},
});
console.log("Followers now:", data.followers_count);
for (const day of data.metrics ?? []) console.log(day.date, day.followers_count, day.video_views, day.likes);
}
dailyInsights(tt).catch(console.error);كيف تتحقق من توقيع webhook؟
أعد حساب HMAC-SHA256 للقيمة t، ثم نقطة، ثم النص الخام للطلب، بمفتاح سر التطبيق، وقارنه بالقيمة s بطريقة ثابتة الزمن، وتحقق من أن t حديثة. اقرأ النص بوصفه بايتات قبل أن يحلله أي شيء، وأجب 200 فوراً، وسجّل x-tt-logid عند فشل التحقق. استخدم Flask في Python، والوحدة http المدمجة في Node.js:
# Python
import hashlib
import hmac
import json
import os
import time
from queue import Queue
from flask import Flask, request
app = Flask(__name__)
events = Queue()
def signature_ok(raw, header, secret, max_age=300):
fields = {}
for part in (header or "").split(","):
key, sep, value = part.strip().partition("=")
if sep:
fields[key] = value
t, s = fields.get("t", ""), fields.get("s", "").lower()
if not t.isdigit() or len(s) != 64:
return False
expected = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, s) and abs(time.time() - int(t)) <= max_age
@app.post("/tiktok/webhook")
def tiktok_webhook():
raw = request.get_data() # the bytes TikTok signed, before any JSON parsing
if not signature_ok(raw, request.headers.get("Tiktok-Signature"), os.environ["TIKTOK_APP_SECRET"]):
app.logger.warning("Bad signature, x-tt-logid %s", request.headers.get("X-Tt-Logid"))
return "", 401
events.put(json.loads(raw)) # its content field is itself a JSON string: work on it elsewhere
return "", 200
// Node.js
const { createServer } = require("node:http");
const { createHmac, timingSafeEqual } = require("node:crypto");
function signatureOk(raw, header, secret, maxAgeSec = 300) {
const fields = {};
for (const part of String(header ?? "").split(",")) {
const i = part.indexOf("=");
if (i > 0) fields[part.slice(0, i).trim()] = part.slice(i + 1).trim();
}
if (!/^\d+$/.test(fields.t ?? "") || !/^[0-9a-f]{64}$/i.test(fields.s ?? "")) return false;
const expected = createHmac("sha256", secret).update(fields.t + ".").update(raw).digest();
const fresh = Math.abs(Date.now() / 1000 - Number(fields.t)) <= maxAgeSec;
return timingSafeEqual(expected, Buffer.from(fields.s, "hex")) && fresh;
}
const inbox = [];
createServer((req, res) => {
if (req.method !== "POST" || req.url !== "/tiktok/webhook") return res.writeHead(404).end();
const chunks = [];
req.on("data", (chunk) => chunks.push(chunk));
req.on("end", () => {
const raw = Buffer.concat(chunks); // the bytes TikTok signed
if (!signatureOk(raw, req.headers["tiktok-signature"], process.env.TIKTOK_APP_SECRET)) {
console.warn("Bad signature, x-tt-logid", req.headers["x-tt-logid"]);
return res.writeHead(401).end();
}
res.writeHead(200).end(); // answer first: TikTok retries anything but a 200 for up to 72 hours
inbox.push(JSON.parse(raw.toString("utf8")));
});
}).listen(3000);كيف تشغّل الأعمال نفسها عبر easyCoexistence؟
كأدوات يستدعيها Claude أو ChatGPT أو أي عميل MCP آخر متصل بـ https://easycoexistence.com/api/mcp، ويأخذ كل استدعاء account_id من list_social_accounts. يرسل easyCoexistence روابط الوسائط إلى TikTok عبر بادئة الروابط الموثّقة الخاصة به، ويتابع كل منشور حتى تُكمله TikTok أو تفشله، ويجدّد الرمز. وعند رفض استدعاء يُعاد رمز TikTok ورسالتها:
// Publish a video by URL, then see where it stands
publish_tiktok_post { "account_id": "<ACCOUNT_ID>", "video_url": "https://media.example.com/tiktok/launch.mp4", "caption": "Our spring menu is live #food" }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "<SHARE_ID>" }
// Post photos
publish_tiktok_post { "account_id": "<ACCOUNT_ID>", "image_urls": ["https://media.example.com/menu/1.jpg", "https://media.example.com/menu/2.jpg"], "title": "Spring menu", "caption": "Four new dishes, from Friday #food" }
// List videos
list_social_posts { "account_id": "<ACCOUNT_ID>", "limit": 20 }
// Read comments and reply in public
list_social_comments { "account_id": "<ACCOUNT_ID>", "post_id": "<ITEM_ID>" }
reply_to_comment { "account_id": "<ACCOUNT_ID>", "post_id": "<ITEM_ID>", "comment_id": "<COMMENT_ID>", "text": "The price list is pinned on our profile." }
// Account insights
get_social_insights { "account_id": "<ACCOUNT_ID>", "metrics": ["followers_count", "video_views", "likes"], "params": { "start_date": "2026-10-26", "end_date": "2026-11-01" } }
// Comment events, signed by easyCoexistence, at your endpoint
set_social_webhook_destination { "account_id": "<ACCOUNT_ID>", "url": "https://hooks.example.com/tiktok/" }كيف يستخدم كودك الخاص حساباً متصلاً بـ easyCoexistence؟
اجلب بيانات اعتماد الحساب لكل مهمة من Partner API ومررها إلى العميل نفسه. يعيد GET إلى /channels/{id}?credentials=1 مع مفتاح ec_live_ الخاص بك القيم api_base وbusiness_id وaccess_token الحالي مع token_expires_at، أو token فارغاً مع ملاحظة عندما تحتاج القناة إلى إعادة الربط. تعمل القراءات والردود والتحليلات من كودك، بينما تمر المنشورات عبر POST /channels/{id}/posts أو publish_tiktok_post، وهي تنقل الوسائط عبر البادئة الموثّقة:
# Python
def tiktok_for(channel_id):
res = requests.get(f"https://easycoexistence.com/api/v1/channels/{channel_id}", params={"credentials": "1"},
headers={"Authorization": f"Bearer {os.environ['EC_API_KEY']}"}, timeout=30)
res.raise_for_status()
creds = res.json()["credentials"]
if not creds.get("access_token"):
raise RuntimeError(creds.get("note")) # the channel needs reconnecting
return TikTok(creds["access_token"], creds["business_id"])
print(recent_videos(tiktok_for("<CHANNEL_ID>"), 20))
// Node.js
async function tiktokFor(channelId) {
const res = await fetch("https://easycoexistence.com/api/v1/channels/" + channelId + "?credentials=1", {
headers: { Authorization: "Bearer " + process.env.EC_API_KEY },
});
if (!res.ok) throw new Error("HTTP " + res.status + " from easyCoexistence");
const { credentials } = await res.json();
if (!credentials.access_token) throw new Error(credentials.note); // the channel needs reconnecting
return new TikTok(credentials.access_token, credentials.business_id);
}
tiktokFor("<CHANNEL_ID>").then((account) => recentVideos(account, 20)).then(console.log, console.error);الأخطاء الشائعة
- قراءة البيانات دون فحص code. قد تأتي الاستجابة برمز HTTP 200 والرمز 40002 دون أي بيانات، فغياب حقل ما غالباً خطأ تجاوزه الكود.
- حذف الشرطة المائلة الأخيرة. تنتهي مسارات TikTok بـ /، وتذكر ملحقات رموز الإرجاع أن /tt_user/oauth2/refresh_token بدونها استدعاء ينتهي برمز HTTP 404 page not found.
- أخذ معرّفات الردود من reply_list في Node.js. تصنّف مراجع TikTok الحقلين comment_id وvideo_id في reply_list بوصفهما أرقاماً، وقد يُقرّبهما JSON.parse، بينما تعيدهما /business/comment/reply/list/ نصوصاً.
- إرسال fields كقائمة مفصولة بفواصل. تريد API for Business نصاً من نوع JSON، مثل fields=["item_id","caption"]، بخلاف Display API على developers.tiktok.com التي تأخذ fields=open_id,union_id.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل تقدم TikTok حزمة SDK رسمية بلغتي Python أو Node.js لواجهة Accounts API؟
تتوفر حزمة SDK الخاصة بـ TikTok API for Business بلغات Python وJavaScript وJava، لكن قائمة endpoints فيها تغطي الإعلانات والتقارير ومركز الأعمال، ولا تضم أي مسار /business/ أو /tt_user/.
لماذا يعيد استدعاء TikTok الرمز HTTP 200 دون بيانات؟
تبلغ TikTok عن الأخطاء في حقل code داخل استجابة HTTP 200. اقرأ code وmessage: 40002 خطأ في معامل، و40001 صلاحية مفقودة، و40100 استدعاء مُقيَّد بسبب تجاوز الحد.
ما إصدارات Python وNode.js التي تحتاجها هذه الأمثلة؟
Python 3.9 أو أحدث مع requests، إضافة إلى Flask لـ webhook، وNode.js 18 أو أحدث، إذ تكفي fetch المدمجة وnode:crypto لباقي المتطلبات.
هل أستطيع استدعاء TikTok API من المتصفح؟
أبقِ الاستدعاءات على خادمك. نوع رمز TikTok هو Bearer، ويستطيع استخدامه كل من يحمله، ونقاط الحصول على الرموز تحتاج إلى client_secret الخاص بتطبيقك.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في