باختصار#
يُقيَّد الوصول بنوعين من الحصص، ولكلٍّ منهما ردٌّ مختلف. ولا يعود أيٌّ منهما بالانتظار دقيقة: لا تنجح إعادة المحاولة إلا بعد رفع الحصة أو إعادة ضبطها.
نوعا الحصة#
| الحصة | ما تعدّه | حين تنفد |
|---|---|---|
| حصة الاشتراك | الطلبات التي يسمح بها اشتراكك في دورة الفوترة | 403 مع Subscription quota exceeded: لا تُعِد المحاولة |
| حصة نقطة النهاية | لبعض نقاط النهاية حصة خاصة بها | 429 مع Endpoint quota exceeded: لا تُعِد المحاولة |
تُعرض الخطط وحدود طلباتها الشهرية في صفحة الأسعار.
الترويسات على نقاط النهاية التي لها حصة#
تعيد نقطة النهاية التي عليها قاعدة حصة عدّاداتها مع كل رد:
X-Endpoint-Quota-Limit: 1000 X-Endpoint-Quota-Used: 417 X-Endpoint-Quota-Remaining: 583
اقرأ X-Endpoint-Quota-Remaining وخطّط مسبقاً قبل أن يبلغ الصفر.
الإشعارات#
حين يبلغ الاستهلاك 80% من حصة الاشتراك يصلك إشعار، وآخر حين تنفد الحصة. ويجري الفحص كل ساعة. وتصل الإشعارات داخل التطبيق وعبر البريد (الأحداث والإشعارات).
ترويسات RateLimit-Limit وRateLimit-Remaining وRateLimit-Reset القياسية على كل رد، وRetry-After على ردود 429 و503.