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

أسباب فشل النشر في TikTok: spam_risk_too_many_posts وpicture_size_check_failed وغيرها

تذكر TikTok سبب فشل المنشور في الحقل reason ضمن نقطة النهاية (endpoint) الخاصة بحالة API for Business، أو في الحقل fail_reason ضمن واجهة Content Posting API الأخرى. تعني أخطاء الفحص، مثل picture_size_check_failed، أن الملف يخالف قاعدة تنسيق ويحتاج إلى تغيير؛ ويعني video_pull_failed أن TikTok لم تتمكن من تنزيله خلال ساعة؛ ويعني spam_risk_too_many_posts وجود عدد كبير من منشورات API خلال 24 ساعة. أما الفشل المعلَّم بالحالة internal فيمكن إعادة محاولته ببساطة.

يتابع easyCoexistence كل منشور TikTok ينشره حتى تُكمله TikTok أو تُفشله، سواء لـ Claude أو ChatGPT أو منصتك الخاصة: يصلك الإخفاق مع سبب TikTok عبر البريد الإلكتروني، وفي شاشة المنشورات، وكحدث post.failed، جاهزاً لإعادة المحاولة.

reason

يُعاد الحقل /business/publish/status/ فقط عندما تكون الحالة FAILED، بقيم مثل frame_rate_check_failed وغيرها.

fail_reason

الاسم الذي يستخدمه Content Posting API لهذا الحقل، ويظهر في استجابات /v2/post/publish/status/fetch/ الخاصة به.

1 hour

مهلة التنزيل التي بعد انقضائها تفشل TikTok المنشور بسبب من video_pull_failed أو photo_pull_failed، وفق نوع الملف.

24 hours

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

3 hours

غالباً ما يرسل easyCoexistence بريداً إلكترونياً إلى المالك عن المنشورات الفاشلة على قناة واحدة، ويبقى المنشور ضمن «بحاجة إلى انتباه».

أين تُبلغ TikTok عن سبب فشل المنشور؟

بعد استدعاء النشر، الذي يبدأ المهمة فقط: الرمز 0 يعني أن TikTok قبلته، لا أن المنشور سيظهر. ثم يعيد GET /business/publish/status/ الحالة FAILED مع reason، ويتلقى التطبيق المشترك في أحداث النشر الحدث post.publish.failed بالسبب نفسه والمعرّف publish_id نفسه. أما /v2/post/publish/status/fetch/ في Content Posting API فيعيد الحقل بالاسم fail_reason:

A failed post in /business/publish/status/, from TikTok's example
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "reason": "frame_rate_check_failed",
    "status": "FAILED"
  }
}

ماذا يعني كل سبب فشل، وما الإصلاح؟

أسباب TikTok كما وردت في مرجع أحداث نشر المنشورات، إلى جانب الإصلاح الذي يشير إليه كل سبب. الأسباب الأربعة الأولى فحوص تجريها TikTok على الملف بعد تنزيله، وكلها مُعلّمة بأنها غير قابلة لإعادة المحاولة. ولا يزال جدول الإخفاقات لدى TikTok يحدد 60 ثانية كأطول مدة لفيديو في duration_check_failed، بينما توثّق نقطة النهاية الخاصة بالفيديو الحد 600 ثانية، أو القيمة الخاصة بالحساب max_video_post_duration_sec:

What TikTok foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing again if the post is still wanted

أي الإخفاقات يمكن إعادة محاولتها؟

تلك التي سببها التنزيل أو TikTok نفسها. أما البقية فتحتاج إلى ملف أو تعليق مختلف، أو انتظار، أو لا شيء على الإطلاق:

  • أعد المحاولة كما هي: internal، وvideo_pull_failed أو photo_pull_failed بعد أن يصبح الرابط عاماً وسريعاً بما يكفي.
  • أعد المحاولة بملف جديد: file_format_check_failed، وduration_check_failed، وframe_rate_check_failed، وpicture_size_check_failed، وهي أخطاء فحص الملف.
  • spam_risk_text: أعد المحاولة بتعليق جديد.
  • spam_risk_too_many_posts: انتظر، أو انشر من تطبيق TikTok على الجوال.
  • لا تعد المحاولة: spam_risk_user_banned_from_posting، وكذلك auth_removed وspam_risk، كما تنصح TikTok بذلك.

كيف تختلف إخفاقات Content Posting API؟

الأسباب نفسها، لكن بحقل ونقطة نهاية مختلفين، ورفض يحدث قبل بدء المعالجة. تعيد /v2/post/publish/status/fetch/ الحقل fail_reason، وتسمح بـ 30 طلباً في الدقيقة لكل رمز مستخدم، وتضيف نصيحة عدم إعادة المحاولة لـ spam_risk_user_banned_from_posting وspam_risk_text. ويصل بعض الرفض عند استدعاء init بدلاً من ذلك، مع HTTP 403:

  • spam_risk_too_many_posts: بلغ المنشئ الحد اليومي للمنشورات عبر API.
  • unaudited_client_can_only_post_to_private_accounts: حاول تطبيق غير مدقَّق النشر لحساب عام.
  • url_ownership_unverified: استخدام PULL_FROM_URL من نطاق أو بادئة لم يتحقق منها التطبيق.
  • privacy_level_option_mismatch: قيمة privacy_level مفقودة أو خارج الخيارات المتاحة للمنشئ.
  • reached_active_user_cap: بلغ التطبيق حصته اليومية من المستخدمين النشطين للنشر.

ما الذي يفشل قبل أن ترى TikTok المنشور؟

ما يستطيع easyCoexistence اكتشافه أولاً، برسالة خاصة به بدلاً من سبب من TikTok. تُنسخ وسائط المنشور المجدول عند جدولته، ويُرفض عندئذٍ الرابط الذي يعيد صفحة ويب، أو 404، أو نوعاً خاطئاً، أو ملفاً يتجاوز 30 ميغابايت للصورة أو 1 غيغابايت للفيديو. وتُرفض روابط الصور التي تنتهي بـ .png أو .gif أو .bmp أو .heic أو .avif أو .svg قبل إرسال أي شيء، وتفشل القناة التي تحتاج إلى إعادة ربط وقت النشر بالسبب reconnect، وإزالة القناة تلغي منشوراتها المجدولة.

كيف يبلغ easyCoexistence عن منشور TikTok فاشل؟

عبر طابور النشر، الذي يتابع كل منشور TikTok بعد استدعاء النشر، فيفحص /business/publish/status/ كل 20 ثانية تقريباً حتى تبلغ الحالة PUBLISH_COMPLETE. تُفشل الحالة FAILED المنشور، ويسمي خطؤه سبب TikTok بين قوسين، مثل frame_rate_check_failed، ويحمل كل إخفاق failure_kind:

  • refused: رفضت TikTok، كما في الحالة FAILED وسببها.
  • uncertain: لم يصل استدعاء النشر إلى جواب واضح، أو لم تؤكد TikTok خلال ساعتين، فقد يكون المنشور منشوراً فعلاً، ويُعلَّم عندها بالقيمة may_be_published على أنه غير محسوم.
  • reconnect: رفضت TikTok رمز الحساب، ويحتاج الحساب إلى تسجيل دخول جديد.
  • internal: فشل easyCoexistence قبل تسليم المنشور، فلم يخرج شيء.

كيف تجد المنشور الفاشل وتعيد محاولته؟

يتلقى المالك بريداً إلكترونياً عن كل إخفاق يُكتشف في الخلفية، بحد أقصى واحد لكل قناة كل 3 ساعات، ويتلقى عنوان URL لأحداث المنصة الحدث post.failed. يظهر المنشور ضمن «بحاجة إلى انتباه» في شاشة المنشورات، مع أزرار إعادة المحاولة وإعادة الربط وتجاهل، وتعيده list_scheduled_posts إلى Claude أو ChatGPT. تنشر retry_scheduled_post المنشور مرة أخرى الآن، من ملفات تُحفظ 7 أيام بعد الفشل؛ وعندما تكون قيمة may_be_published صحيحة، تحقق أولاً من list_social_posts، ومرر confirm فقط إذا كان المنشور مفقوداً. أما المنشور الذي يحتاج إلى ملف أو تعليق جديد فيُجدول من جديد بدلاً من ذلك.

Failed posts through MCP
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }

retry_scheduled_post { "post_id": "<POST_ID>" }

// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }

الأخطاء الشائعة

  • إعادة محاولة إخفاق فحص بالملف نفسه. تعدّ TikTok إخفاقات التنسيق والمدة ومعدل الإطارات وحجم الصورة غير قابلة لإعادة المحاولة.
  • إعادة محاولة spam_risk_too_many_posts فوراً. تحسب TikTok منشورات API على مدى 24 ساعة، وتقترح النشر من تطبيق الجوال.
  • إعادة محاولة منشور مُعلَّم may_be_published دون التحقق منه. قد تكون TikTok نشرته فعلاً؛ تحقق من أحدث منشورات الحساب، وإلا خرج المنشور مرتين.
  • البحث عن fail_reason في API for Business. تسمي نقطة النهاية الخاصة بالحالة الحقل reason، أما fail_reason فخاص بواجهة Content Posting API الأخرى.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويتناقص السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

ماذا يعني picture_size_check_failed في TikTok؟

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

ما هو video_pull_failed؟

لم تتمكن TikTok من تنزيل الفيديو من عنوان URL الخاص به، أو لم تتمكن من ذلك خلال مهلة الساعة الواحدة. تحقق من أن الرابط عام وغير مقيّد بعرض النطاق، ثم أعد المحاولة.

كم تستمر spam_risk_too_many_posts؟

تحسب TikTok المنشورات المرسلة عبر API خلال آخر 24 ساعة، أي نحو 15 منشوراً في اليوم لكل حساب، وتقترح النشر من تطبيق TikTok على الجوال في الأثناء.

هل يعيد easyCoexistence محاولة منشور TikTok الفاشل تلقائياً؟

لا، بعد أن تبلغ TikTok بالحالة FAILED: يبقى المنشور ضمن «بحاجة إلى انتباه» ويُرسل بريد إلكتروني إلى المالك، وتعيد إرساله الأداة retry_scheduled_post أو الزر «إعادة المحاولة».

تابع القراءة

كيفية متابعة حالة نشر منشور TikTok عبر واجهة برمجة التطبيقات (API)متابعة منشور TikTok المرسل عبر واجهة برمجة التطبيقات (API): share_id، والحالات PROCESSING_DOWNLOAD وPUBLISH_COMPLETE وFAILED، ومعرّفات المنشور وأسباب الفشل.حدود نشر منشورات TikTok عبر واجهة برمجة التطبيقات (API): عدد المنشورات في اليومعدد المنشورات التي تنشرها واجهة TikTok لكل حساب: ستة في الدقيقة و15 في اليوم، وما يحدث عند تجاوز الحد.عناوين URL لوسائط TikTok: نطاقات وبادئات URL موثّقةكيف تسحب واجهة برمجة التطبيقات (API) من TikTok وسائط المنشورات من نطاقات وبادئات URL موثّقة عبر سجل DNS TXT وملف توقيع، ونقاط نهاية الممتلكات.منشورات الصور وعروض الشرائح على TikTok عبر API: حتى 35 صورةكيف تنشر واجهة TikTok للأعمال منشورات الصور: من 1 إلى 35 صورة بصيغة JPEG أو WebP حتى 20 ميغابايت لكل صورة، مع عنوان وتعليق وصورة غلاف.إرسال فيديو إلى مسودات المنشئ على TikTok عبر الواجهة البرمجيةكيف ترسل واجهات TikTok البرمجية فيديو إلى مسودات المنشئ: تدفق الرفع في Content Posting API، وupload_to_draft، وis_draft، ونطاق video.uploadلماذا تبقى منشورات TikTok عبر واجهة برمجة التطبيقات (API) خاصة: unaudited_client_can_only_post_to_private_accountsلماذا تبقى منشورات Content Posting API على TikTok خاصة حتى اجتياز التدقيق، ومعنى خطأ 403، وكيف تختلف عنها API for Business في النشر العام.

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

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

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

تم التحقق في