اختبار TikTok API قبل الموافقة: بيئة Sandbox
يتيح وضع Sandbox في TikTok for Developers تجربة تكامل التطبيق مع واجهة برمجة التطبيقات (API) قبل إرساله للمراجعة: حتى 5 بيئات، تُعد كل منها إعدادًا منفصلًا عن التطبيق المنشور، يختبرها ما يصل إلى 10 حسابات مستهدفة تضيفها بتسجيل دخولها الخاص. ولا يشمل Content Posting API للفيديوهات العامة ولا Data Portability API.
يتصل easyCoexistence بحساب TikTok تملكه عبر تسجيل الدخول على TikTok، من خلال تطبيق المطور الخاص به لـ API for Business، فيمكنك تجربة النشر والتعليقات والتحليلات من Claude أو ChatGPT أو شيفرتك الخاصة دون بيئة Sandbox ولا مراجعة تطبيق.
أكبر عدد من بيئات Sandbox يتيح TikTok for Developers إنشاءه، لتجربة التكاملات دون إرسال التطبيق للمراجعة.
أكبر عدد من المستخدمين المستهدفين يمكن إضافته؛ وإضافة حساب تملكه تتطلب بيانات تسجيل دخوله.
عندما توقف TikTok حسابات Sandbox الخاصة بـ API for Business، فإنها تنصح المطورين بإنشاء حساب اختبار في بيئة الإنتاج.
الحد المسموح لكل نقطة نهاية (endpoint) في حسابات Sandbox الخاصة بـ API for Business، إلى جانب طلب واحد في الثانية و1,000 طلب يوميًا.
المدة التي قد تستغرقها الحسابات المستهدفة المضافة حديثًا لتظهر في صفحة التطبيق بعد التحديث.
ما هو وضع Sandbox في TikTok؟
بيئة مقيّدة على developers.tiktok.com يعمل فيها تكامل التطبيق قبل المراجعة. تصفه TikTok بأنه وسيلة لتجربة التكاملات دون إرسال التطبيق، ولتجربة الإعدادات دون المساس بالنسخة المنشورة. تحتفظ كل بيئة بتفاصيل التطبيق ومنتجاته الخاصة، ويجرّبها الحسابات المستهدفة التي تضيفها.
كيف تُنشئ بيئة Sandbox؟
من صفحة التطبيق في بوابة المطورين. وفق خطوات TikTok، بعد أن يكون لديك حساب مطور، ويُنصح بإنشاء منظمة أو الانضمام إليها دون أن يكون ذلك إلزاميًا:
- افتح Manage apps، واختر التطبيق أو اربطه، ثم حوّل مفتاح التبديل بجوار اسمه إلى وضع Sandbox.
- انقر Create Sandbox، وسمِّها، واختر اختياريًا استنساخ النسخة المنشورة أو بيئة Sandbox أخرى.
- حرّر App details، وأضف المنتجات المراد اختبارها، ثم انقر Apply changes لتطبيق التغييرات.
- أضف المزيد عبر زر [+] في اللوحة الجانبية، بحد أقصى 5 بيئات في المجموع.
كيف تعمل الحسابات المستهدفة؟
هي حسابات TikTok التي تجرّب بيئة Sandbox. ضمن Sandbox settings ثم Target users، اختر Add account، وسجّل الدخول بالحساب ووافق على TikTok Developer Terms of Service. تنبّه TikTok إلى أن الحساب الذي تملكه يحتاج إلى بيانات تسجيل دخوله لإضافته، وأن المستخدمين الجدد قد يستغرقون ساعة واحدة ليظهروا بعد التحديث. يمكن إضافة ما يصل إلى 10 حسابات، ثم يمكن تفويضها عبر Login Kit والمنتجات التي تعتمد عليه، مع الحاجة إلى URL decoder في تلك الخطوة.
ماذا تستثني بيئة Sandbox؟
النشر العام وقابلية نقل البيانات. تذكر صفحة Sandbox لدى TikTok أن هذا الوضع لا يتيح الوصول إلى Content Posting API للفيديوهات العامة ولا إلى Data Portability API. كما أن المنشورات العامة تنتظر أكثر من المراجعة: فحتى يجتاز عميل Content Posting API تدقيق TikTok، ينشر بصيغة الظهور SELF_ONLY، من حسابات خاصة، لما يصل إلى 5 مستخدمين خلال 24 ساعة.
كيف تتصل بيئة Sandbox بمراجعة التطبيق؟
منها يأتي عرض الفيديو التوضيحي للإرسال الأول. تشترط إرشادات المراجعة لدى TikTok أن يُظهر التطبيق الذي لم تتم الموافقة عليه من قبل تكامله في بيئة Sandbox على بوابة المطورين. ويمكن بعد ذلك استيراد إعداد Sandbox إلى مسودة في وضع Production، وهذا يستبدل المسودة، أما Revert to Live version فيعيد الإعداد المعتمد.
هل توجد بيئة Sandbox لـ API for Business؟
توجد بيئة واحدة للإعلانات، وهي في طور الإيقاف. حسابات Sandbox الخاصة بـ API for Business هي حسابات إعلانية، يُوصل إليها عبر https://sandbox-ads.tiktok.com/open_api مع بيانات تقارير وهمية، بحساب واحد لكل تطبيق مطور، ويُحد بطلب واحد في الثانية و30 طلبًا في الدقيقة و1,000 طلب يوميًا على كل endpoint. تغطي نقاط النهاية المدعومة الحملات والمجموعات الإعلانية والإعلانات ورفع الإبداعات والتقارير والشروط والهويات، دون endpoint لـ Accounts API تحت business/. وتوقفها TikTok بحلول 1 ديسمبر 2026، وتنصح بحساب اختبار في بيئة الإنتاج.
كيف تختبر Accounts API دون بيئة Sandbox؟
على حساب حقيقي تملكه ومخصص للاختبار. فوّض التطبيق بهذا الحساب، وتحقق من نطاقات رمز الوصول (token) بالمسار /tt_user/token_info/get/، وجرّب النشر باستخدام رابط الفيديو التجريبي الذي توفره TikTok لـ /business/video/publish/، والذي لا يحتاج إلى التحقق من الرابط. كما يشير دليل البدء لدى TikTok إلى مجموعة Postman الخاصة بـ API for Business لتجربة الاستدعاءات. تُحتسب منشورات الاختبار ضمن حدود ذلك الحساب، وهي 6 منشورات في الدقيقة و15 منشورًا في اليوم.
كيف يتناسب easyCoexistence مع الاختبار؟
بلا أي إعداد على جانب TikTok. يتصل حساب TikTok تملكه بـ easyCoexistence بتسجيل الدخول عبر TikTok، من خلال تطبيق المطور الخاص بـ easyCoexistence لـ API for Business، فلا توجد بيئة Sandbox أو مراجعة أو تدقيق لك تنتظره. ثم يتولى Claude أو ChatGPT أو شيفرتك الخاصة النشر والرد على التعليقات وقراءة التحليلات في ذلك الحساب، عبر الأدوات نفسها التي ستستخدمها حسابات عملائك.
الأخطاء الشائعة
- التخطيط لاختبارات النشر العام داخل Sandbox. بيئة Sandbox لا تتيح Content Posting API للفيديوهات العامة.
- إضافة مستخدم مستهدف دون بيانات تسجيل دخوله. تطلب TikTok بيانات حساب تملكه عند إضافته كمستخدم مستهدف.
- بدء اختبارات جديدة على حسابات الإعلانات في بيئة Sandbox الخاصة بـ API for Business. ستوقفها TikTok بحلول 1 ديسمبر 2026 وتشير إلى حسابات الاختبار في بيئة الإنتاج.
- تقديم تطبيق لم تتم الموافقة عليه من قبل دون فيديو توضيحي من Sandbox. تشترط إرشادات TikTok عرض التكامل في Sandbox للمراجعة الأولى.
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية لأول 3 أيام.
الأسئلة الشائعة
لماذا لا تظهر الحسابات المستهدفة في TikTok Sandbox؟
تنبّه TikTok إلى أن الحسابات المستهدفة المضافة حديثًا قد تستغرق ساعة واحدة لتظهر في صفحة التطبيق بعد التحديث. كما أن إضافة حساب تملكه تتطلب بيانات تسجيل دخوله.
هل تحتاج بيئة Sandbox في TikTok إلى تطبيق مطور منفصل؟
لا. تعيش بيئات Sandbox داخل التطبيق نفسه على developers.tiktok.com، حتى 5 بيئات، ولكل منها تفاصيلها ومنتجاتها الخاصة، ومفصولة عن النسخة المنشورة.
هل تُحتسب منشورات الاختبار على حساب TikTok حقيقي ضمن حدوده؟
نعم. تُحتسب المنشورات المنشورة أثناء اختبار Accounts API على حساب حقيقي ضمن حديه: 6 منشورات في الدقيقة و15 منشورًا في اليوم، شأنها شأن أي منشور آخر.
ماذا ينبغي أن يُظهر الفيديو التوضيحي لبيئة Sandbox في TikTok؟
التكامل من البداية إلى النهاية، مع استخدام كل نطاق مطلوب. تطلب إرشادات المراجعة لدى TikTok من التطبيق الذي لم تتم الموافقة عليه من قبل أن يُظهره في Sandbox، والعرض الذي يتخطى المسار أو أحد النطاقات سبب شائع للرفض.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في