تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

نطاقات 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 الأخرى.

18000000

معرّف نطاق TikTok Accounts، وهو الإذن الأعلى مستوى فوق نقاط نهاية الملف الشخصي والمنشورات والتعليقات والنشر في Accounts API.

user.account.type

النطاق الذي يقف وراء is_business_account وhas_advanced_access في بيانات ملف الحساب الشخصي.

comment.list

النطاق الذي يجب أن يمنحه المالك ويُبقيه نشطاً كي يستقبل التطبيق أحداث خطاف الويب (webhook) الخاصة بـ comment.update.

video.upload

النطاق الذي يحتاجه الرمز لرفع منشور كمسودة بدلاً من نشره.

2 to 3 days

أيام العمل التي قد تستغرقها مراجعة 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، لذا توقّع المجموعتين من الأسماء:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

أي نطاقات الرمز تفتح أي حقل؟

تحدد مراجع 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، وتطابق أسماؤها نقاط نهاية النشر وإدارة التعليقات، ومع ذلك لا تربط مراجعها أي حقل بأي منهما.

Read the scopes an access token carries
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 تنتمي إلى إعدادات التطبيق.
إنجاز ذلك باستخدام EasyCoexistence

من 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.

تابع القراءة

رموز وصول TikTok API for Business: 24 ساعة والتجديد والإلغاءشرح كيف تصدر واجهة TikTok API for Business رموز الحسابات: تبديل رمز التفويض، ورمز وصول مدته 24 ساعة، والتجديد والإلغاء.TikTok API for Business مقابل Content Posting APIلماذا TikTok API for Business بدلًا من developers.tiktok.com: التعليقات والتحليلات وتجديد رموز الوصول.إعداد webhooks الخاصة بـ TikTok API for Businessكيف تشترك في webhooks لتطبيق TikTok API for Business عبر /business/webhook/update/ لأحداث الفيديو والتعليقات، مع التحقق من التوقيع.مقاييس فيديو TikTok عبر واجهة برمجة التطبيقات (API): المشاهدات ووقت المشاهدة والإكمالمقاييس كل فيديو تعيدها واجهة TikTok للأعمال: المشاهدات والوصول ووقت المشاهدة ونسبة الإكمال والاحتفاظ ومصادر الظهور وبلدان المشاهدين.ديموغرافيا الجمهور في TikTok عبر واجهة برمجة التطبيقات (API)ديموغرافيا متابعي الحساب في واجهة TikTok للأعمال: العمر والجنس والدولة والمدينة والنشاط بالساعة، وشرط 100 متابع.واجهة TikTok Analytics API: مؤشرات الحساب ومقاييس الفيديومقاييس TikTok التي تعيدها واجهة API الخاصة بالأعمال: المتابعون والمشاهدات والإعجابات يوميًا للحساب، والمشاهدات والإعجابات والتعليقات والمشاركات لكل فيديو.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في