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

كيفية متابعة حالة نشر منشور 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 وأي سبب للفشل كما هي.

3 min

المدة التي قد تستغرقها معرّفات المنشورات بعد PUBLISH_COMPLETE؛ تنصح TikTok بإعادة المحاولة بعد ثلاث دقائق إذا كانت مفقودة.

30 min

تقدير TikTok العام لتنزيل ملف منشور بحجم 1 GB؛ الوقت الفعلي يعتمد على الحجم والشبكة.

2 min

أطول انتظار معتاد، بعد اكتمال الرفع، حتى يصبح المنشور متاحًا للعموم؛ قد تستغرق المراجعة اليدوية وقتًا أطول.

1 hour

مهلة التنزيل التي تفشل بعدها 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 إذا تعذّر عليها جلب الملف.
إنجاز ذلك باستخدام EasyCoexistence

من 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 فشل؟

يتوقف ذلك على السبب. يمكن إعادة محاولة فشل التنزيل والفشل الداخلي؛ أما فشل الصيغة والمدة ومعدل الإطارات وحجم الصورة فيحتاج إلى ملف مصحَّح.

تابع القراءة

متطلبات فيديو TikTok لواجهة برمجة التطبيقات (API): الصيغة والحجم والمدةالفيديوهات التي تنشرها TikTok API for Business: MP4 أو MOV أو WebM، من 3 إلى 600 ثانية، حتى 1 GB، و23 إلى 60 إطارًا في الثانية، من رابط يُنزله TikTok بنفسه.حدود نشر منشورات TikTok عبر واجهة برمجة التطبيقات (API): عدد المنشورات في اليومعدد المنشورات التي تنشرها واجهة TikTok لكل حساب: ستة في الدقيقة و15 في اليوم، وما يحدث عند تجاوز الحد.جدولة منشورات TikTok عبر واجهة برمجة التطبيقات (API)كيف تُجدول فيديوهات TikTok ومنشورات الصور عبر API: طابور ينشرها في التاريخ والوقت اللذين تحددهما، وفق قواعد TikTok لحظة الإرسال.أحداث webhook لتعليقات TikTokكيف يُبلغ حدث comment.update في TikTok عن التعليقات والردود، وما يحمله كل حدث، ووصوله موقّعًا إلى نقطة النهاية (endpoint) الخاصة بك.واجهة TikTok Analytics API: مؤشرات الحساب ومقاييس الفيديومقاييس TikTok التي تعيدها واجهة API الخاصة بالأعمال: المتابعون والمشاهدات والإعجابات يوميًا للحساب، والمشاهدات والإعجابات والتعليقات والمشاركات لكل فيديو.خطأ TikTok 40007: الكائن غير موجوديعني خطأ TikTok 40007 أن الطلب يشير إلى كائن أو URL أو ملف غير موجود. حدّد معرّفات واجهة الحسابات الواجب فحصها ومصدر كل منها.

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

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

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

تم التحقق في