حدود معدل طلبات Facebook Graph API: الأخطاء 4 و17 و32 و613 و80001
يمنح Graph API من Facebook الرمز المميز للصفحة أو لمستخدم النظام 4,800 استدعاء لواجهة Pages API لكل مستخدم تفاعل مع الصفحة خلال نافذة متحركة مدتها 24 ساعة. عند تجاوز الحد يعيد الخادم أحد الأخطاء: 4، Application request limit reached؛ 17، User request limit reached؛ 32، Page request limit reached؛ 613، Calls to this api have exceeded the rate limit؛ أو 80001، There have been too many calls to this Page account. توقف عن الاستدعاء، ثم استأنف تدريجيًا.
تستدعي easyCoexistence كل صفحة متصلة برمزها الخاص، وتتلقى نشاط خلاصتها والإشارات والرسائل عبر webhooks من Meta، وتمرّرها إلى نقطة النهاية (endpoint) الخاصة بك إن أردت، فلا يحتاج أي شيء إلى استطلاع الصفحة.
الخطأ الذي يظهر عندما يبلغ التطبيق، الذي يُستخدم رمزه في الطلب، حد معدل الطلبات الخاص به.
الخطأ الذي يظهر عندما يبلغ المستخدم، الذي يُستخدم رمزه في الطلب، حد معدل الطلبات الخاص به.
الخطأ الذي يظهر عندما يبلغ المستخدم أو التطبيق، اللذان يُستخدم رمزهما في طلب Pages API، حد معدل الطلبات الخاص به.
الخطأ الخاص بحد معدل مخصص؛ ومع الرمز الفرعي 1996، لاحظت Meta سلوكًا غير متسق في حجم طلبات التطبيق.
رمز حالة Business Use Case لاستدعاءات الصفحات المرسلة برمز وصول للصفحة أو لمستخدم النظام.
عدد استدعاءات Pages API المسموح بها خلال نافذة متحركة مدتها 24 ساعة باستخدام رمز صفحة أو مستخدم نظام.
ماذا يعني كل حد من حدود المعدل؟
يسمّي كل خطأ الحد الذي تم بلوغه، ورمز الوصول في الطلب هو ما يحدد الحد الذي يُطبَّق. يشرح دليل Meta لتحديد المعدل ما يشير إليه كل رمز، وتعرض مراجع الأخطاء الرسالة المرافقة له. وفيما يلي الأخطاء جنبًا إلى جنب، مع الرسالة كما كتبتها Meta:
| Meta's message | What reached its limit | |
|---|---|---|
| 4 | Application request limit reached | The app whose token made the request |
| 17 | User request limit reached | The user whose token made the request |
| 32 | (#32) Page request limit reached | The user or app token used in a Pages API request |
| 613 | (#613) Calls to this api have exceeded the rate limit. | A custom limit set by the API being called |
| 80001 | (#80001) There have been too many calls to this Page account. Wait a bit and try again. | Calls made on that Page with a Page or system user token |
أي حد ينطبق على الصفحة؟
يتوقف ذلك على الرمز. تقول Meta إن حدود معدل الصفحات قد تعتمد على منطق Platform أو منطق Business Use Case، بحسب نوع الرمز المستخدم. تخضع استدعاءات Pages API المرسلة برمز صفحة أو مستخدم نظام لحد Business Use Case الخاص بالصفحات، بينما تخضع الاستدعاءات المرسلة برمز مستخدم أو تطبيق لحدود Platform الخاصة بالمستخدم أو التطبيق. وإذا كان الحدان محتملين لطلب واحد، تطبّق Meta حد Business Use Case.
ما حجم الحدود؟
تنشر Meta صيغًا بدلًا من أرقام ثابتة، لذلك يزداد كل حد مع الاستخدام:
- التطبيقات: 200 استدعاء في الساعة لكل مستخدم نشط يوميًا، تُحتسب على جميع استدعاءات التطبيق معًا لا لكل مستخدم على حدة.
- الصفحات، برمز صفحة أو مستخدم نظام: 4,800 استدعاء خلال نافذة متحركة مدتها 24 ساعة لكل مستخدم تفاعل مع الصفحة خلال 24 ساعة.
- Messenger Send API: 300 استدعاء في الثانية لكل صفحة للنصوص والروابط والتفاعلات والملصقات، و10 للصوت أو الفيديو.
- لاستدعاءات Messenger أيضًا نوع Business Use Case خاص بها، ويُبلَّغ عنه بالخطأ 80006.
كيف تعرف أن حدًا يقترب؟
اقرأ ترويسات الاستخدام. تتضمن نقاط النهاية التي تستقبل عددًا كافيًا من الطلبات من التطبيق الترويسة X-App-Usage، وتمثل call_count وtotal_cputime وtotal_time نسبًا مئوية من حدود Platform الخاصة بالتطبيق. وتتضمن الاستجابات المحدودة بموجب منطق Business Use Case الترويسة X-Business-Use-Case-Usage بدلًا منها، بالنسب المئوية نفسها لكل كائن أعمال، ونوع الحد مثل pages، وestimated_time_to_regain_access.
X-App-Usage: {"call_count": 28, "total_time": 25, "total_cputime": 25}
X-Business-Use-Case-Usage: {
"{business-object-id}": [
{
"type": "pages",
"call_count": 100,
"total_cputime": 34,
"total_time": 41,
"estimated_time_to_regain_access": 12
}
]
}كم تنتظر؟
حتى ينخفض الاستخدام، وهو ما تبيّنه الترويسات. بالنسبة إلى حد Business Use Case مثل 80001، تعطي estimated_time_to_regain_access عدد الدقائق حتى لا تعود الاستدعاءات مقيّدة. أما حدود Platform فإن call_count للتطبيق يغطي فترة متحركة مدتها ساعة واحدة، لذا ينخفض مع خروج الاستدعاءات الأقدم من النافذة. وتوجيه Meta واحد في الحالتين: توقف عن إرسال الاستدعاءات بمجرد بلوغ الحد، لأن الاستمرار في الاستدعاء يرفع عدد الاستدعاءات والوقت اللازم حتى تنجح الاستدعاءات من جديد.
كيف تبقى دون الحدود؟
قلّل عدد الاستدعاءات وخفّف حجمها ووزّعها على فترات. توصي أفضل ممارسات Meta بتوزيع الاستعلامات بالتساوي لتجنب الذروات المفاجئة، واستخدام المرشحات للحد من حجم الاستجابات وتجنب الاستدعاءات التي تطلب بيانات متداخلة، وعند تقييد المستخدمين، التأكد من أن التطبيق ليس السبب. وتساعد خطافات الويب (webhook) أيضًا، إذ تسلّم Meta نشاط خلاصة الصفحة والرسائل فور حدوثه، فلا يحتاج التطبيق إلى إنفاق استدعاءات للبحث عنها.
الأخطاء الشائعة
- إعادة المحاولة فورًا. تحذر Meta من أن الاستمرار في الاستدعاء يرفع عدد الاستدعاءات والوقت اللازم حتى تنجح الاستدعاءات من جديد.
- معاملة كل الأخطاء بالطريقة نفسها. 4 هو حد التطبيق، و17 حد المستخدم، و80001 حد الصفحة، لذا فإن إبطاء الطرف الخاطئ لا يغيّر شيئًا.
- قراءة X-App-Usage لاستدعاءات مرسلة برمز صفحة. هذه الاستدعاءات تُحتسب ضمن حد Business Use Case وتُبلَّغ في X-Business-Use-Case-Usage.
- استطلاع صفحة هادئة بكثرة. يتناسب المسموح به مع المستخدمين الذين تفاعلوا معها، لذا فالصفحة ذات التفاعل القليل تملك استدعاءات أقل لتنفقها.
عندما تقيّد Meta استدعاءً، تعيد الأداة رمز Meta ورسالتها إلى Claude أو ChatGPT أو الكود الخاص بك، فيستطيع الذكاء الاصطناعي لديك الانتظار قبل المحاولة من جديد، وتُعاد محاولة أي منشور تقيّده Meta تلقائياً بعد 5 دقائق و30 دقيقة و2 ساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية لمدة 3 أيام.
الأسئلة الشائعة
ما الذي تعنيه رسالة Application request limit reached في الخطأ 4؟
إنه الخطأ 4: التطبيق الذي أرسل الاستدعاء برمزه بلغ حد معدل الطلبات الخاص به. توقف عن إرسال الاستدعاءات، ثم استأنف تدريجيًا مع انخفاض استخدامه.
ما الفرق بين الخطأ 32 والخطأ 80001؟
الرمز. الخطأ 32 هو حد Platform على رمز مستخدم أو تطبيق عند استدعاء Pages API، أما 80001 فهو الحد الخاص بكل صفحة على الاستدعاءات المرسلة برمز صفحة أو مستخدم نظام.
ما هي المدة التي تستمر فيها حدود معدل الطلبات؟
لا تحدد Meta وقتًا ثابتًا. بالنسبة إلى 80001، تعطي ترويسة X-Business-Use-Case-Usage عدد الدقائق حتى لا تعود الاستدعاءات مقيّدة، ويُقاس استخدام التطبيق خلال ساعة متحركة.
ماذا يعني الخطأ 613؟
حد معدل مخصص تحدده واجهة API التي يتم استدعاؤها. ومع الرمز الفرعي 1996، لاحظت Meta سلوكًا غير متسق في حجم طلبات التطبيق، مثلًا بعد تغيير حديث في عدد الطلبات التي يرسلها.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في