كيفية متابعة حالة نشر منشور TikTok عبر واجهة برمجة التطبيقات (API)
تُنشر المنشورات عبر واجهة برمجة التطبيقات (API) على TikTok بشكل غير متزامن: يعيد طلب النشر share_id، ويوضح GET /business/publish/status/ بهذا المعرف بوصفه publish_id أين وصل المنشور. تظهر الحالة PROCESSING_DOWNLOAD أثناء تنزيل TikTok للملف، وPUBLISH_COMPLETE بعد اجتياز المنشور للمراجعة ونشره، أو FAILED مع سبب مثل frame_rate_check_failed.
ينشر easyCoexistence إلى TikTok باستخدام publish_tiktok_post، ويتابع كل منشور عبر get_tiktok_publish_status، سواء من Claude أو ChatGPT أو من كودك الخاص، فيرى ذكاؤك الاصطناعي حالة TikTok وأي سبب للفشل كما هي.
المدة التي قد تستغرقها معرّفات المنشورات بعد PUBLISH_COMPLETE؛ تنصح TikTok بإعادة المحاولة بعد ثلاث دقائق إذا كانت مفقودة.
تقدير TikTok العام لتنزيل ملف منشور بحجم 1 GB؛ الوقت الفعلي يعتمد على الحجم والشبكة.
أطول انتظار معتاد، بعد اكتمال الرفع، حتى يصبح المنشور متاحًا للعموم؛ قد تستغرق المراجعة اليدوية وقتًا أطول.
مهلة التنزيل التي تفشل بعدها TikTok المنشور برمز video_pull_failed أو photo_pull_failed.
لماذا يحتاج منشور TikTok إلى متابعة؟
لأن TikTok ينشره في الخلفية. يبدأ طلب النشر مهمة ويعيد share_id فورًا، ثم تنزّل TikTok الملف من عنوان URL الخاص به، وتتحقق من الصيغة، وتجري المراجعة، وتجعل المنشور عامًا. يمكن أن يفشل المنشور بعد نجاح الطلب نفسه.
ما الحالات المتاحة؟
يأخذ GET /business/publish/status/ معرّف business_id الخاص بالحساب وshare_id بوصفه publish_id، ويعيد إحدى أربع حالات:
PROCESSING_DOWNLOAD: تنزّل TikTok المحتوى من عنوان URL الخاص به.PUBLISH_COMPLETE: اجتاز المنشور المراجعة ونُشر؛ تسردpost_idsالمنشور حين يصبح مرئيًا للعموم.- FAILED: توقف النشر، ويوضح reason السبب.
SEND_TO_USER_INBOX: رُفعت مسودة وأُبلغ صندوق وارد المبدع؛ تنطبق هذه الحالة على المسودات فقط.
كم يستغرق النشر؟
لا تحدد TikTok وقتًا ثابتًا. يعتمد التنزيل على حجم الملف والشبكة، وتقدّر TikTok عمومًا أن 30 دقيقة تكفي لملف بحجم 1 GB، وأن الحد الأقصى ساعة. بعد ذلك يصبح المنشور عادةً عامًا خلال دقيقتين، أو لاحقًا إذا احتاج إلى مراجعة يدوية، وقد يحتاج معرّف المنشور إلى حتى ثلاث دقائق إضافية ليظهر في الحالة.
ماذا تعني أسباب الفشل؟
يسمّي reason ما أوقف المنشور. بعضها يعني أن الملف يجب أن يتغير، وبعضها يعني أن إعادة المحاولة قد تنجح:
file_format_check_failedوduration_check_failedوframe_rate_check_failedوpicture_size_check_failed: الملف يخالف قاعدة في الصيغة، وتصنّفها TikTok على أنها غير قابلة لإعادة المحاولة.video_pull_failedوphoto_pull_failed: لم تتمكن TikTok من تنزيل الملف، أو لم تفعل ذلك خلال الساعة؛ أعد المحاولة بعد أن يصبح عنوان URL متاحًا للوصول العام.- internal: كان جزء من خدمة TikTok غير متاح، وإعادة المحاولة مقبولة.
spam_risk_too_many_postsوspam_riskوspam_risk_text: أوقفت TikTok المنشور بسبب الحجم أو السلوك أو محتوى النص المرافق للمنشور.auth_removed: سحب الحساب صلاحية التطبيق أثناء المعالجة، وتقول TikTok إنه لا ينبغي إعادة المحاولة.spam_risk_user_banned_from_posting: الحساب محظور من نشر منشورات جديدة.
ما فائدة معرّف المنشور؟
للعثور على المنشور لاحقًا. تمرّر مرجعية TikTok معرّفات المنشورات إلى /business/video/list/ في filters.video_ids لقراءة مقاييس المنشورات. أما استدعاءات التعليقات فتأخذ item_id الخاص بالمنشور من قائمة الفيديوهات في الحساب بوصفه video_id، وهو ما تأخذه أدوات التعليقات في easyCoexistence بوصفه post_id.
كيف تتابع easyCoexistence المنشور؟
يعيد publish_tiktok_post معرّف share_id من TikTok مع ملاحظة بأن TikTok تعالج المنشور، ويأخذ get_tiktok_publish_status ذلك share_id ويعيد حالة TikTok كما هي الآن، مع السبب عند وجوده. اطلب من ذكائك الاصطناعي التحقق مرة أخرى بعد بضع دقائق لا فورًا.
الأخطاء الشائعة
- إعادة النشر لأن شيئًا لم يظهر بعد. كان الطلب الأول قد بدأ المهمة فقط، لذا تحقّق من حالته قبل إرسال المنشور مرة ثانية.
- اعتبار PUBLISH_COMPLETE بلا post_ids خطأ. قد تستغرق المعرّفات ثلاث دقائق إضافية، فتحقّق مجددًا بعدها.
- إعادة محاولة فشل الصيغة بالملف نفسه. يحتاج file_format_check_failed وسائر أخطاء الفحص إلى ملف مصحَّح.
- إيقاف عنوان URL أثناء التنزيل. تفشل TikTok المنشور برمز video_pull_failed أو photo_pull_failed إذا تعذّر عليها جلب الملف.
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، تنخفض كلما أضفت اتصالات، مع أول 3 أيام مجانية.
الأسئلة الشائعة
ما هو share_id في TikTok؟
معرّف مهمة النشر، تعيده نقاط النهاية الخاصة بنشر الفيديو والصور. يُمرَّر في استدعاء الحالة بوصفه publish_id.
هل يوجد خطاف الويب (webhook) لحالة نشر TikTok؟
نعم. يتلقى تطبيق مشترك بقيمة VIDEO في event_type عبر /business/webhook/update/ أحداث نشر المنشورات، مثل post.publish.failed مع سببه وpublish_id، بدلًا من تكرار فحص الحالة.
لماذا لا يملك منشور تم نشره معرّف منشور بعد؟
قد تستغرق TikTok حتى ثلاث دقائق بعد PUBLISH_COMPLETE لإعادة post_ids، ولا تعيدها إلا للمنشورات المرئية للعموم.
هل يمكن إعادة محاولة منشور TikTok فشل؟
يتوقف ذلك على السبب. يمكن إعادة محاولة فشل التنزيل والفشل الداخلي؛ أما فشل الصيغة والمدة ومعدل الإطارات وحجم الصورة فيحتاج إلى ملف مصحَّح.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في