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

خطأ TikTok 40100: طلبات مرسلة بتكرار مفرط

يعني الخطأ 40100 في TikTok أن حد المعدل قيّد الطلب: يرد TikTok بالرمز 40100 داخل متن استجابة HTTP 200، لذلك لا تكفي الحالة وحدها لكشفه. والحل هو إيقاف الاستدعاءات إلى نقطة النهاية (endpoint) لمدة 5 دقائق بعد حد الدقيقة، أو حتى 00:00 UTC بعد الحد اليومي، ثم إرسال طلبات أقل وأكبر حجماً.

يعيد easyCoexistence رمز TikTok ورسالته إلى Claude أو ChatGPT أو كودك الخاص، فيستطيع الذكاء الاصطناعي لديك التمييز بين حد المعدل ونشر فاشل، فينتظر قبل المحاولة مجدداً.

40100

الرمز الذي يعيده TikTok عند بلوغ حد المعدل، أي أن الطلب تعرض للتقييد.

HTTP 200

الحالة التي يرسلها TikTok مع رموز الإرجاع، بما فيها 40100؛ ولا يعني النجاح إلا الرمز 0 في المتن.

40 QPM

حد معدل Accounts API لكل حساب TikTok مفوّض على كل endpoint.

600 QPM

كل endpoints في Accounts API مجتمعة، لكل تطبيق مطوّر على المستوى Basic؛ والمستويات الأعلى تسمح بـ 1,000.

5 minutes

المدة التي يطلب TikTok انتظارها قبل الاستدعاء مجدداً بعد بلوغ حد الدقيقة.

15 a day

أقصى عدد من منشورات الفيديو يمكن للحساب نشره عبر واجهة برمجة التطبيقات (API) في اليوم، بمعدل ستة في الدقيقة كحد أقصى.

ماذا يعني الخطأ 40100؟

أوقف حدّ المعدل الطلب. يصف TikTok في ملحق رموز الإرجاع الرمز 40100 بأنه طلبات مرسلة بتكرار مفرط، لأنه تم بلوغ الحد على مستوى تطبيق المطوّر لذلك endpoint، ويذكر دليل حدود المعدل أن الخادم يعيد 40100 عند بلوغ أي حد. ويجب إيقاف الاستدعاءات إلى هذا endpoint حتى يُرفع الإيقاف.

كيف تكتشف 40100 في الكود؟

من خلال الرمز في المتن لا من حالة HTTP. يرسل TikTok رموز الإرجاع مع HTTP 200، لذا تحقق من الحقل code في كل استجابة: الرمز 0 يعني النجاح، و40100 يعني طلباً مقيّداً. تشير الحالة 4xx إلى مسار أو طريقة خاطئة، وعند 5xx ينصح TikTok بالانتظار نحو 5 دقائق قبل إعادة المحاولة:

Reading TikTok's answer in Node.js
// TikTok returns its error codes with HTTP 200: read code, not only the status.
async function callTikTok(url, accessToken) {
  const res = await fetch(url, { headers: { "Access-Token": accessToken } });
  if (res.status >= 500) return { retryInMs: 5 * 60_000 }; // TikTok: wait about 5 minutes
  if (!res.ok) throw new Error("HTTP " + res.status + ": check the path and the method");
  const body = await res.json();
  if (body.code === 40100) return { retryInMs: 5 * 60_000 }; // throttled: pause this endpoint
  if (body.code !== 0) throw new Error("TikTok " + body.code + ": " + body.message);
  return { data: body.data };
}

أي حدود يمكن أن تعيد 40100؟

يذكر دليل حدود المعدل في TikTok أن الخادم يعيد 40100 عند بلوغ أي حد من حدود المعدل، ويُحتسب كل حد على حدة، والأرقام الكاملة حسب مستوى التطبيق في صفحة حدود المعدل. يُحتسب استدعاء Accounts API على ثلاثة حدود:

  • 40 استعلاماً في الدقيقة لكل حساب مفوّض على كل endpoint في Accounts API، وهو الرقم نفسه في كل مستويات التطبيق.
  • 600 استعلام في الدقيقة عبر Accounts API لكل تطبيق مطوّر على المستوى Basic، و1,000 فوق ذلك.
  • حدود التطبيق لكل endpoint بالثانية والدقيقة واليوم، وتُحدَّد حسب مستوى التطبيق.

كم يجب أن تنتظر؟

يتوقف ذلك على الحد الذي تم بلوغه. بعد حد الدقيقة يقول TikTok إن عليك الانتظار 5 دقائق قبل الاستدعاء مجدداً. أما بعد الحد اليومي فانتظر حتى اليوم التالي، لأن الحدود اليومية تُعاد ضبطها عند 00:00:00 UTC. ويضيف دليل TikTok أن حدود كل endpoint مستقلة، فبلوغ حد endpoint واحد لا يوقف الاستدعاءات إلى endpoint آخر.

هل سقف 15 منشوراً في اليوم هو الحد نفسه؟

لا. يحسب سقف النشر عدد المنشورات: ستة في الدقيقة و15 في اليوم لكل حساب على كل endpoint للنشر، ويفشل المنشور الذي يتجاوزه في حالة النشر بالرمز spam_risk_too_many_posts لا بالرمز 40100. ونصيحة TikTok لهذا الفشل هي نشر المنشور من تطبيق TikTok للجوال، وتغطي ذلك صفحة قيود النشر.

كيف تبقى ضمن الحدود؟

ينصح TikTok بإرسال طلبات أقل وأكبر حجماً، وبتحديد عدد الطلبات التي تعمل في الوقت نفسه. في Accounts API يعني ذلك قراءة حتى 20 منشوراً في كل صفحة من /business/video/list/ وحتى 30 تعليقاً في كل صفحة من /business/comment/list/ بدلاً من جلبها واحداً تلو الآخر، أو توزيع الاستدعاءات بدلو الرموز (token bucket)، أو وضعها في طابور يرسلها عدد ثابت من العمال، فتعود المهام الفاشلة إلى الطابور بعد تأخير.

هل يوقف رفع مستوى التطبيق الأعلى الخطأ 40100؟

فقط عندما يكون حد التطبيق هو الحد الذي تم بلوغه. يبدأ كل تطبيق على المستوى Basic، ويرفعه TikTok مستوى واحداً في كل مرة، من Basic إلى Advanced ثم Premium وUltimate، وذلك بطلب يُقدَّم ضمن My Apps وApp Detail وAuthorization مع ذكر السبب. ويذكر دليل Accounts API حد 40 في الدقيقة لكل حساب وكل endpoint كرقم واحد مستقل عن مستوى التطبيق، لذلك يُعالج الحساب المزدحم بتباعد استدعاءاته.

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

  • إعادة المحاولة فوراً. يبقى endpoint مقيّداً حتى يُرفع الإيقاف، لذا فالمحاولات السريعة تستهلك استدعاءات دون أن تنجح.
  • جلب المنشورات أو التعليقات واحداً تلو الآخر. يعيد استدعاء القائمة صفحة من 20 منشوراً أو 30 تعليقاً، ويُحتسب كل استدعاء ضمن حد الـ40 في الدقيقة.
  • الاستعلام عن حالة النشر في حلقة متواصلة. كل فحص هو استدعاء إلى /business/publish/status/، وقد تحتاج معرّفات المنشورات حتى ثلاث دقائق لتظهر، فباعد بين الفحوص.
  • معاملة spam_risk_too_many_posts كحد معدل. فهو يحسب المنشورات التي أُنشئت عبر API خلال آخر 24 ساعة، لا الاستدعاءات في الدقيقة، لذا فإبطاء الاستدعاءات لا يعالجه.
إنجاز ذلك باستخدام EasyCoexistence

تقرأ أدواته التعليقات بواقع 30 في الصفحة والمنشورات حتى 20 في المرة، ويُخبر الأداة publish_tiktok_post الذكاء الاصطناعي مسبقاً بأن TikTok يحدّ النشر عبر API بنحو 15 منشوراً في اليوم لكل حساب. من US$ 9 إلى US$ 0.75 لكل رقم متصل شهرياً، ويقل السعر كلما أضفت أرقاماً، مع أول 3 أيام مجاناً في الفترة التجريبية.

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

هل يعيد TikTok رمز HTTP 429 عند تقييد الاستدعاء؟

تصف أدلة TikTok الاستدعاء المقيّد بالرمز 40100 في متن استجابة HTTP 200، ولا تذكر أي حالة 429، لذا تحقق من الحقل code في كل استجابة.

كم يستمر تقييد 40100 في TikTok؟

يقول TikTok إن عليك الانتظار 5 دقائق بعد بلوغ حد الدقيقة. أما الحد اليومي فيُرفع عند 00:00:00 UTC حين يُعاد ضبطه.

هل يعيد easyCoexistence محاولة استدعاء أعاد 40100؟

ليس من تلقاء نفسه. يعود الاستدعاء المقيّد إلى الذكاء الاصطناعي برمز 40100 ورسالة TikTok، والمنشور المقيّد في الطابور يفشل برسالة الخطأ نفسها ويبقى ضمن قسم Needs attention حتى تختار Retry.

هل يختلف 40100 عن 40016؟

يعطي ملحق TikTok الرمزين الوصف نفسه، أي طلبات مرسلة بتكرار مفرط على مستوى تطبيق المطوّر، والحل نفسه: راجع دليل حدود المعدل. أما 40133 فيغطي مستوى المعلِن.

تابع القراءة

حدود معدل TikTok API: الطلبات لكل حساب وتطبيق ونقطة نهايةحدود معدل TikTok API: 40 طلباً في الدقيقة لكل حساب ونقطة نهاية، و600 أو 1,000 في الدقيقة لكل تطبيق في Accounts API، والمستويات الأربعة للتطبيق.حدود نشر منشورات TikTok عبر واجهة برمجة التطبيقات (API): عدد المنشورات في اليومعدد المنشورات التي تنشرها واجهة TikTok لكل حساب: ستة في الدقيقة و15 في اليوم، وما يحدث عند تجاوز الحد.خطأ TikTok 40002: خطأ في المعامل ضمن الطلبيعني الخطأ 40002 في TikTok أن معامل الطلب مفقود أو مشوه أو غير مسموح به. كيفية قراءة رسالة TikTok وقواعد Accounts API التي يجب التحقق منها.خطأ TikTok 40001: لا توجد صلاحية لتنفيذ العمليةيعني الخطأ 40001 في TikTok أن الاستدعاء لا يملك صلاحية العملية. كيف تتحقق من صلاحية تطبيقك في TikTok Accounts ونطاقات الرمز.خطأ TikTok 40007: الكائن غير موجوديعني خطأ TikTok 40007 أن الطلب يشير إلى كائن أو URL أو ملف غير موجود. حدّد معرّفات واجهة الحسابات الواجب فحصها ومصدر كل منها.خطأ TikTok 40105: رمز الوصول غير صالح أو غير صحيحيعني الخطأ 40105 من TikTok أن رمز الوصول غير صالح أو غير صحيح. ما الذي تتحقق منه، وكيف تجدده، ومتى يجب على المالك إعادة التفويض.

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

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

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

تم التحقق في