دليل TikTok API (واجهة برمجة التطبيقات) لعام 2026: من تطبيقك إلى أول منشور
للانتقال من تطبيق المطورين إلى أول منشور على TikTok في 2026، سجّل كشركة في API for Business من TikTok، وأنشئ تطبيقاً بصلاحية TikTok Accounts، واطلب من مالك الحساب تفويضه، ثم استبدل auth_code برمز الوصول (token) الصالح لمدة 24 ساعة، واستدعِ /business/video/publish/ مع عنوان فيديو موثَّق. تابع share_id الذي يعيده حتى تصل الحالة إلى PUBLISH_COMPLETE، ثم أضف التعليقات، وwebhooks، والتحليلات.
يتولى easyCoexistence الجانب الخاص بالمطورين نيابةً عنك: تطبيقه على API for Business ومساره للوسائط الموثَّقة، وتجديد الرموز، والتحقق من كل حساب نحو كل 6 ساعات، فيستطيع Claude أو ChatGPT أو منصتك نشر المنشورات والرد على التعليقات وقراءة التحليلات على TikTok عبر موصل MCP واحد أو Partner API.
متى يرد TikTok على تسجيل المطور، وهو يتطلب بريداً إلكترونياً لنطاق شركة موثَّق وموقعاً إلكترونياً للشركة.
التاريخ الذي تحتاج فيه التطبيقات الجديدة، وطلبات توسيع النطاقات التي تتضمن صلاحية TikTok Accounts، أولاً إلى نموذج Accounts API Access Application Form.
مدة صلاحية auth_code الذي تعيده موافقة المالك، وهو يعمل لاستبدال واحد فقط عبر /tt_user/oauth2/token/.
ما تعيده كلتا نقطتي النشر، ويُمرَّر كـ publish_id إلى /business/publish/status/ لمتابعة المنشور.
وضع الرؤية الذي يطبّقه TikTok على المحتوى المنشور عبر Content Posting API من التطبيقات التي لم يدققها بعد.
عدد الطلبات لكل حساب مفوَّض على كل نقطة من نقاط Accounts API، ضمن ميزانية للتطبيق قدرها 600 في الدقيقة على المستوى Basic.
ما هو مسار الانتقال من تطبيق مطور على TikTok إلى أول منشور؟
خمس مراحل على API for Business من TikTok، ولكل منها مراجعة أو تحقق خاص بها. يتم التسجيل ومراجعة التطبيق مرة واحدة، ويتم التفويض مرة واحدة لكل حساب يديره التطبيق، وتتكرر المرحلتان الأخيرتان مع كل منشور. تتناول الأقسام التالية المراحل بالترتيب، مع نقطة النهاية والحقل والحد الذي يتعلق بكل منها:
أي TikTok API تحتاج؟
الواجهة التي تناسب المهمة. يدير TikTok بوابتين للمطورين: business-api.tiktok.com لـ API for Business، وdevelopers.tiktok.com لـ TikTok for Developers، وهي البوابة التي تضم Content Posting وDisplay وResearch APIs. لإدارة المنشورات والتعليقات والتحليلات لحسابات يملكها نشاط تجاري أو يخدمه، تكون API for Business هي الخيار، لأنها تتضمن نقاط التعليقات، ويرسل webhooks الخاصة بالتعليقات:
أي حسابات TikTok يمكن للتطبيق إدارتها؟
حسابات شخصية وحسابات أعمال على حد سواء. يحدد Accounts API من TikTok ثلاثة مستويات: حساب TikTok العام الذي يبدأ به الجميع؛ وحساب بوصول متقدم، مرتبط بحساب TikTok for Business أو بـ Business Center غير موثَّق؛ وحساب النشاط الموثَّق. لا تحدد نقاط النشر والتعليقات مستوى حساب، بينما تتطلب بعض حقول التحليلات وMentions API وBusiness Messaging API وصولاً متقدماً أو حساب نشاط موثَّقاً.
كيف تسجّل التطبيق وتحصل على موافقته؟
كشركة، على بوابة TikTok for Business Developers، عبر ثلاث خطوات يراجعها TikTok:
- تسجيل المطور: بريد إلكتروني لنطاق شركة موثَّق، وموقع إلكتروني عام للشركة على نطاق تملكه؛ يرد TikTok خلال ثلاثة أيام عمل، ولا يقبل المطورين الأفراد.
- نموذج Accounts API Access Application Form: مطلوب منذ 20 مارس 2026 قبل أي تطبيق جديد، أو توسيع نطاق، يتضمن صلاحية TikTok Accounts.
- تطبيق المطور: استخداماته المقصودة ومن يمكنه الوصول إليه، وعنوان URL لإعادة التوجيه، وصلاحية TikTok Accounts، وتُراجَع خلال 2 إلى 3 أيام عمل، مع حد أقصى خمسة تطبيقات لكل مطور.
ما الصلاحيات والنطاقات التي يحتاجها التطبيق؟
طبقتان تمنحهما جهتان مختلفتان. يحمل تطبيق المطور صلاحيات تحت TikTok Accounts، تُختار ضمن Scope of permission ويراجعها TikTok، وكل صلاحية تفتح نقاط نهاية. تضع موافقة مالك الحساب نطاقات على الـ token، وهذه تفتح الحقول والميزات، مثل user.insights للمقاييس اليومية للحساب، وvideo.list وvideo.insights لبيانات المنشورات، وvideo.upload للمسودات، وcomment.list لـ webhook التعليقات. يعرض /tt_user/token_info/get/ النطاقات التي يحملها الـ token.
كيف يفوّض الحساب التطبيق، وما وظيفة الرموز؟
يفتح المالك رابط تفويض حامل الحساب الخاص بالتطبيق، الموجود تحت My Apps وApp Detail وBasic Information، ويوافق على صلاحياته. يعيد TikTok التوجيه إلى عنوان URL لإعادة التوجيه الخاص بالتطبيق مع auth_code، ويستبدل الخادم الكود عند /tt_user/oauth2/token/ برمز وصول صالح لمدة 24 ساعة، وبـ refresh token صالح لمدة سنة، وبمعرّف open_id الخاص بالحساب. يُرسل الـ token في ترويسة Access-Token، ويُرسل open_id في business_id مع كل طلب لـ Accounts API، ويجدّد /tt_user/oauth2/refresh_token/ الرمز.
كيف تنشر فيديو ومنشور صور؟
بطلب POST لكل منهما، من عناوين URL ينزّلها TikTok بنفسه، على نطاق أو بادئة URL موثَّقة للتطبيق. يأخذ /business/video/publish/ القيم business_id وvideo_url وpost_info، ويحمل post_info النص المصاحب ووسوم العلامة التجارية، وهو مطلوب حتى لو كان فارغاً. يأخذ /business/photo/publish/ حتى 35 صورة في الحقل photo_images بصيغة JPG أو JPEG أو WebP، ويكون privacy_level في post_info مطلوباً. يعيد كلاهما share_id، ويسمح TikTok بحد أقصى ستة منشورات في الدقيقة و15 منشوراً في اليوم لكل حساب عبر كل نقطة منهما.
كيف تعرف أن المنشور نُشر؟
اسأل /business/publish/status/ مع business_id وshare_id بوصفه publish_id، أو اشترك في webhooks النشر. تنتقل الحالة من PROCESSING_DOWNLOAD إلى PUBLISH_COMPLETE، أو تتوقف عند FAILED مع سبب مثل frame_rate_check_failed، وتدل SEND_TO_USER_INBOX على مسودة. يصل post_ids بعد أن يصبح المنشور مرئياً للجميع، بعد PUBLISH_COMPLETE بثلاث دقائق كحد أقصى، وتُرشِّح /business/video/list/ حسب هذه المعرّفات لقراءة مقاييس المنشور.
كيف تقرأ التعليقات وتردّ عليها؟
على منشورات الحساب نفسه، بواسطة video_id، وهو item_id من /business/video/list/. تعيد GET /business/comment/list/ التعليقات العامة والمخفية، حتى 30 في الصفحة، وتنشر POST /business/comment/reply/create/ رداً عاماً يصل إلى 1,200 حرف، وهو حد رفعه TikTok من 150 حرفاً في 7 أغسطس 2026. تخفي نقاط أخرى تعليقاً أو تعيد إظهاره، وتحذف التعليقات التي كتبها الحساب نفسه.
كيف تعمل webhooks على API for Business؟
لكل تطبيق لا لكل حساب. يشترك التطبيق بإرسال POST إلى /business/webhook/update/ مع app_id وsecret وevent_type وcallback_url عبر HTTPS: يجلب VIDEO أحداث النشر الأربعة، ويرسل COMMENT حدث comment.update خلال خمس دقائق من كل تغيير. يُوقَّع كل إرسال في ترويسة Tiktok-Signature بخوارزمية HMAC-SHA256 مفتاحها المفتاح السري للتطبيق، ويحتاج إلى استجابة HTTP 200 فوراً، وإن لم تحدث تُعاد المحاولة حتى 72 ساعة.
من أين تأتي التحليلات؟
من نقطتين. تعيد GET /business/get/ الملف الشخصي والمقاييس اليومية للحساب، مثل followers_count وvideo_views وprofile_views وlikes، حتى 60 يوماً إلى الوراء بالتوقيت العالمي UTC. وتعيد GET /business/video/list/ المجاميع الكلية لكل منشور منذ نشره، من video_views وreach حتى average_time_watched، حتى 20 منشوراً في الصفحة. تصل معظم الأرقام متأخرة من 24 إلى 48 ساعة، ويحتاج كل حقل إلى نطاقه على الـ token.
ما الحدود التي تشكّل التكامل؟
أربعة حدود، يُحسب كل منها على حدة:
- 40 طلباً في الدقيقة لكل حساب مفوَّض على كل نقطة من Accounts API.
- 600 طلب في الدقيقة لمجموع طلبات Accounts API للتطبيق على المستوى Basic، و1,000 في المستويات الأعلى.
- ستة منشورات في الدقيقة و15 منشوراً في اليوم لكل حساب على كل نقطة نشر.
- الخطأ 40100 داخل استجابة HTTP 200 عندما يقيّد TikTok طلباً: توقّف 5 دقائق بعد حد الدقيقة، أو حتى 00:00 UTC بعد حد اليوم.
ما هو المسار عبر easyCoexistence؟
أقصر، لأن easyCoexistence أنجز الجانب الخاص بالمطورين بتطبيقه على API for Business ومساره للوسائط الموثَّقة. يتصل حساب شخصي أو حساب نشاط تجاري بتسجيل الدخول إلى TikTok، ثم يعمل Claude أو ChatGPT أو منصتك الخاصة معه عبر موصل MCP واحد أو Partner API، دون تسجيل أو مراجعة تطبيق أو خادم رموز خاص بك:
الأخطاء الشائعة
- إرسال التطبيق قبل نموذج الوصول. منذ 20 مارس 2026 يطلب TikTok نموذج Accounts API Access Application Form أولاً لأي تطبيق جديد أو طلب نطاق يتضمن TikTok Accounts.
- استضافة الوسائط على نطاق لم يوثّقه التطبيق. يُنزّل TikTok الـ video_url وphoto_images بنفسه، ويرفض عناوين URL خارج نطاق أو بادئة URL موثَّقة.
- التصميم لحساب واحد. تخص الـ tokens وbusiness_id وحد 40 طلباً في الدقيقة كل حساب، بينما تخص إعدادات الـ webhook وميزانية الطلبات المجمعة التطبيق، لذا صمّم المستويين منذ البداية.
- طلب النطاقات التي تحتاجها ميزة اليوم فقط. يحتفظ الـ token بالنطاقات التي وافق عليها المالك، لذا فإن إضافة التعليقات أو التحليلات لاحقاً تعني أن يفوّض كل مالك التطبيق من جديد.
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، وينخفض السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل أحتاج إلى تطبيق مطور منفصل على TikTok لكل حساب عميل؟
لا. يخدم تطبيق مطور واحد الحسابات التي تفوّضه، ولكل حساب token وbusiness_id خاصان به، ويسمح TikTok بحد أقصى خمسة تطبيقات لكل مطور.
هل Accounts API هو نفسه Marketing API من TikTok؟
لا. كلاهما ضمن API for Business، لكن Marketing API يشغّل الإعلانات برموز معلنين لا تنتهي صلاحيتها، بينما يستخدم Accounts API رموز حسابات TikTok التي تدوم يوماً واحداً.
أي إصدار من TikTok API ينبغي أن يستخدمه الكود الجديد؟
الإصدار v1.3، المتاح منذ 15 أغسطس 2022 دون تاريخ انتهاء محدد. توقف v1.2 عن تلقي التحديثات بعد 15 أغسطس 2023، ولا يُدخل TikTok تغييرات غير متوافقة إلا في الإصدارات الجديدة.
كم يكلّف easyCoexistence لكل حساب TikTok؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، بحسب الشريحة التي يقع فيها إجمالي عددك، مع فترة تجريبية مجانية مدتها 3 أيام. يمثّل كل حساب TikTok اتصالاً واحداً.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في