الحدود والأحجام

للحفاظ على استقرار المنصة، يوجد في API قيود على معدل الطلبات وحجم البيانات المُرسَلة.

معدل الطلبات

عند تجاوز المعدل المسموح به، يستجيب الخادم بكود 429 Too Many Requests. الاستجابة الصحيحة — إعادة المحاولة مع تأخير أسي (backoff): زد الفترة الفاصلة بين المحاولات ولا ترسل الطلبات في تدفق متواصل. وزّع العمليات الجماعية عبر الزمن وأعد استخدام رمز واحد بشكل متسلسل بدلاً من دفعات متوازية.

حجم جسم الطلب

بالنسبة لطلبات REST العادية، يقتصر حجم جسم JSON على 2 MiB. هذا كافٍ لأي إعدادات تفاعلات ومجموعات وإعدادات. إن كان الجسم أكبر — قسّم العملية (مثلاً استورد التفاعلات على دفعات).

حجم جسم الاستيراد

نقاط نهاية الاستيراد مصممة لحزم كبيرة ولها حدود أعلى منفصلة: حتى 64 MiB لاستيراد البيانات وحتى 256 MiB لاستيراد مع وسائط مضمّنة. إن كانت الحزمة أكبر — قسّمها على عدة عمليات استيراد.

تجاوز الحدود

  • تجاوز حد المعدل — 429، أعد المحاولة مع تأخير.
  • الجسم أكبر من المسموح — يُرفض الطلب (413 أو 400 حسب نقطة النهاية)؛ قلّص أو قسّم الحمولة.

الخطوات التالية