نطاقات TikTok API for Business: ما يفتحه كل إذن
تمنح واجهة برمجة التطبيقات (API) الخاصة بـ TikTok for Business الوصول على طبقتين. يحمل تطبيق المطوّر أذونات ضمن TikTok Accounts، مثل Video Publish وManage Account Comment، وهي التي تفتح نقاط النهاية (endpoints). أما تفويض مالك الحساب فيمنح رمز الوصول (token) نطاقات مثل user.insights وvideo.list، وهي التي تحدد الحقول المُعادة. ويسرد /tt_user/token_info/get/ النطاقات التي يحملها الرمز.
يطلب easyCoexistence من مالك حساب TikTok أذونات تطبيقه في تسجيل دخول واحد، فيستطيع Claude أو ChatGPT أو الشيفرة الخاصة بك النشر والعمل على التعليقات وقراءة المقاييس عبر أدواته، ويمنح get_social_credentials شيفرتك الخاصة الرمز نفسه لنقاط نهاية Accounts API الأخرى.
معرّف نطاق TikTok Accounts، وهو الإذن الأعلى مستوى فوق نقاط نهاية الملف الشخصي والمنشورات والتعليقات والنشر في Accounts API.
النطاق الذي يقف وراء is_business_account وhas_advanced_access في بيانات ملف الحساب الشخصي.
النطاق الذي يجب أن يمنحه المالك ويُبقيه نشطاً كي يستقبل التطبيق أحداث خطاف الويب (webhook) الخاصة بـ comment.update.
النطاق الذي يحتاجه الرمز لرفع منشور كمسودة بدلاً من نشره.
أيام العمل التي قد تستغرقها مراجعة TikTok لتعديل أذونات تطبيق المطوّر.
ما طبقتا أذونات TikTok؟
أذونات التطبيق ونطاقات الرمز. تُختار أذونات التطبيق من My Apps، ثم التطبيق، ثم Scope of permission، وتراجعها TikTok، وتأتي في ثلاثة مستويات، ويغطي الإذن من المستوى الأول كل نقطة نهاية أدناه. أما نطاقات الرمز فهي ما وافق عليه مالك الحساب عند تفويض التطبيق، وتُعاد في حقل scope واحد نصه مفصول بفواصل مع كل رمز. يحتاج الطلب إلى إذن التطبيق لنقطة نهايته، وبعض حقول الاستجابة تحتاج أيضاً إلى نطاق على الرمز.
أي إذن للتطبيق يفتح كل endpoint؟
تسرد مرجعية API الخاصة بـ TikTok، لكل endpoint من Accounts API، الإذن ضمن TikTok Accounts الذي يفتحه، أو بلا إذن. وتسمّي مرجعية نطاقات الأذونات ودليل webhook المجموعات نفسها Business User وBusiness Media وBusiness Comment وBusiness Content، لذا توقّع المجموعتين من الأسماء:
أي نطاقات الرمز تفتح أي حقل؟
تحدد مراجع TikTok لـ /business/get/ و/business/video/list/ إذناً مطلوباً لكل حقل في الاستجابة، وتمنح ميزتان أخريان نطاقاً خاصاً بهما:
- user.info.basic:
display_nameوprofile_image. - user.info.username: username، وكان يحتاج إلى user.info.basic حتى يونيو 2023.
- user.info.profile:
profile_deep_linkوbio_descriptionوis_verified. - user.info.stats:
following_countوfollowers_countوtotal_likesوvideos_count. - user.account.type:
is_business_accountوhas_advanced_access. - user.insights: المقاييس اليومية للحساب وتوزيع المتابعين حسب العمر والجنس والدولة والمدينة.
- video.list: حقول المنشور مثل
item_idوcaption وshare_urlوlikes وcomments وshares وreach وvideo_views. - video.insights: مدة المشاهدة، ونسبة المشاهدة الكاملة، والاحتفاظ بالمشاهدين، ومصادر الزيارات، وتفاصيل المشاهدين، والنقرات التي يحققها المنشور.
- comment.list: حدث comment.update من webhook، وتصفه TikTok بأنه قراءة تعليقات المحتوى داخل التطبيق وردودها.
- video.upload: رفع منشور فيديو أو صورة كمسودة، باستخدام
upload_to_draftأوis_draft.
كيف ترى النطاقات على الرمز؟
اسأل /tt_user/token_info/get/، وهو يأخذ app_id ورمز الوصول، ويعيد نطاق الرمز وcreator_id الخاص بالحساب. وتتضمن أمثلة TikTok لسلاسل النطاقات أيضاً video.publish وcomment.list.manage، وتطابق أسماؤها نقاط نهاية النشر وإدارة التعليقات، ومع ذلك لا تربط مراجعها أي حقل بأي منهما.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
-H 'Content-Type: application/json' \
-d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"app_id": "<APP_ID>",
"creator_id": "<OPEN_ID>",
"scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
}
}ما الذي يطلبه اتصال easyCoexistence بـ TikTok؟
الأذونات التي يحملها تطبيق المطوّر، وتظهر جميعها في صفحة الموافقة لدى TikTok. يرسل easyCoexistence مالك الحساب إلى عنوان URL لتفويض صاحب حساب TikTok الذي تولّده بوابة TikTok لتطبيقه، وهو يسمّي هذه الأذونات أصلاً، ويضيف إليه قيمة state خاصة به فقط. يوافق المالك على ما تعرضه TikTok، وتُخزَّن سلسلة النطاقات التي تعيدها TikTok مع الاتصال. نقاط النهاية التي يستدعيها easyCoexistence بعد ذلك للحساب:
- /business/get/ للملف الشخصي والمقاييس اليومية وتوزيع المتابعين.
- /business/video/list/ للمنشورات ومقاييسها.
- /business/video/publish/ و/business/photo/publish/ و/business/publish/status/ للنشر.
- /business/comment/list/ و/business/comment/reply/create/ و/business/comment/hide/ و/business/comment/delete/ للتعليقات.
- /business/webhook/update/ على مستوى التطبيق، لخطاف webhook التعليقات.
كيف تضيف إذناً لاحقاً؟
على خطوتين، واحدة لكل طبقة. بالنسبة للتطبيق، افتح My Apps، ثم التطبيق، ثم Scope of permission، وعدّله، واذكر سبباً يطابق النطاقات الجديدة، ثم أرسله. قد تستغرق مراجعة TikTok من يومي عمل إلى ثلاثة أيام عمل، ومنذ 20 مارس 2026 يحتاج أي طلب يتضمن TikTok Accounts أولاً إلى نموذج Accounts API Access Application Form. أما الرمز، فيفوّض المالك التطبيق من جديد، لأن الرمز يحتفظ بالنطاقات التي وافق عليها عند إصداره.
ماذا يحدث عند غياب إذن؟
بالنسبة للاستدعاء، يعيد TikTok رمز الخطأ 40001، وتعني أنه لا يوجد إذن لتنفيذ العملية المرتبطة، ويشير إصلاحه إلى مرجع نطاقات الأذونات. أما بالنسبة للحقل، فتتيحه المراجع فقط بعد أن يمنح المالك نطاقه، وإصلاحها أن يفوّض المالك التطبيق من جديد بذلك النطاق. تحقق من نطاق الرمز عبر /tt_user/token_info/get/ قبل أن تطلب ذلك.
الأخطاء الشائعة
- توقّع أن تكتسب الحسابات المتصلة إذن تطبيق جديداً من تلقاء نفسها. فرموزها تحتفظ بالنطاقات التي وافق عليها المالك عند التفويض، حتى يفوّض كل مالك التطبيق من جديد.
- طلب is_business_account دون user.account.type. فـ TikTok لا تتيح هذا الحقل وhas_advanced_access إلا للرموز التي تحمل ذلك النطاق.
- انتظار comment.update دون comment.list. فـ TikTok لا ترسل أحداث التعليقات إلا ما دام تفويض المالك بذلك النطاق ساريًا.
- البحث في الرمز عن أسماء أذونات التطبيق. فسلسلة النطاقات تستخدم أسماء مثل video.list، بينما أسماء مثل Get Account Media تنتمي إلى إعدادات التطبيق.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
ما النطاقات التي تستخدمها واجهة TikTok API for Business؟
نطاقات الرمز مثل user.info.basic وuser.info.stats وuser.insights وvideo.list وvideo.insights وcomment.list وvideo.upload، ويمنحها مالك الحساب فوق أذونات TikTok Accounts الخاصة بالتطبيق.
أي الأذونات يحتاجها webhook التعليقات في TikTok؟
يحتاج التطبيق إلى TikTok Accounts وBusiness Comment، ويجب أن يمنح المالك comment.list. وتتوقف الأحداث إذا انتهى هذا التفويض أو أُلغي.
هل ينطبق نطاق جديد من TikTok على الرموز الصادرة سابقاً؟
لا. يحتفظ الرمز بالنطاقات التي وافق عليها عند إصداره، لذلك يفوّض مالك الحساب التطبيق من جديد لإضافة نطاق جديد.
كم تستغرق موافقة TikTok على إذن جديد؟
تقول TikTok إن مراجعة تعديل الإذن قد تستغرق من يومي عمل إلى ثلاثة أيام عمل، والطلبات التي تضيف TikTok Accounts أولاً تحتاج إلى نموذج Accounts API Access Application Form.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في