أسباب فشل النشر في 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، جاهزاً لإعادة المحاولة.
يُعاد الحقل /business/publish/status/ فقط عندما تكون الحالة FAILED، بقيم مثل frame_rate_check_failed وغيرها.
الاسم الذي يستخدمه Content Posting API لهذا الحقل، ويظهر في استجابات /v2/post/publish/status/fetch/ الخاصة به.
مهلة التنزيل التي بعد انقضائها تفشل TikTok المنشور بسبب من video_pull_failed أو photo_pull_failed، وفق نوع الملف.
نافذة زمنية تقف وراء spam_risk_too_many_posts، وتقترح TikTok نشر ذلك المنشور من تطبيقها على الجوال بدلاً من ذلك.
غالباً ما يرسل 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:
{
"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 found | The fix | |
|---|---|---|
| file_format_check_failed | The file's format breaks TikTok's specifications | MP4, MOV or WebM video; JPG, JPEG or WebP photos |
| duration_check_failed | The video's length is outside the limits | At least 3 seconds, within the account's maximum |
| frame_rate_check_failed | Below 23 or above 60 frames per second | Export at 23 to 60 FPS |
| picture_size_check_failed | Height or width under 360 pixels | At least 360 pixels on each side |
| video_pull_failed, photo_pull_failed | The download failed or ran past one hour | A public URL that is not bandwidth-limited, then a retry |
| internal | Part of TikTok's service was unavailable | A retry |
| auth_removed | The owner removed the app's access mid-processing | No retry; the owner authorizes the app again |
| spam_risk_too_many_posts | Too many API posts in the last 24 hours | Posting from the TikTok mobile app, or waiting |
| spam_risk_user_banned_from_posting | The account is banned from making new posts | No retry while the account cannot post |
| spam_risk_text | The caption reads as risky or spammy | New text before posting again |
| spam_risk | High spam risk, such as attempts made too often | No retry, as TikTok advises |
| publish_cancelled | The upload or download was cancelled | Publishing 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 فقط إذا كان المنشور مفقوداً. أما المنشور الذي يحتاج إلى ملف أو تعليق جديد فيُجدول من جديد بدلاً من ذلك.
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 الأخرى.
من 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 أو الزر «إعادة المحاولة».
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في