في هذه الصفحة
باختصار#
نوعان من الحصص يوقفان الاستدعاء، ولكلٍّ منهما جواب مختلف. الانتظار دقيقة لا يفيد: تبقى الحصة مستنفَدة حتى تُشحن أو تُجدَّد أو تتغيّر، فلا تكرّر محاولة استدعاء رُفض بسبب حصة.
الحصتان#
| الحصة | ما تعدّه | حين تنفد |
|---|---|---|
| حصة الاشتراك | الطلبات التي يتيحها اشتراكك في مدته. وفي منتجاتك المجانية هي حصة خطة منصتك، وعدّاد واحد مشترك بينها. | 403 مع Subscription quota exceeded |
| حصة نقطة النهاية | طلبات كل نقطة نهاية، في المنتجات المسعَّرة لكل نقطة نهاية. | 429 مع Endpoint quota exceeded |
والتطبيق المشترك في منتج مسعَّر لكل نقطة نهاية، وليست له قاعدة حصة لنقطة النهاية التي يستدعيها، يحصل على 403 مع No endpoint quota rule found for this consumer. افتح اشتراكاتي وتحقق من أن نقطة النهاية جزء من اشتراكك.
خطط المنصة وأسعارها وحصص طلباتها مسرودة في صفحة الأسعار. وهي تتغيّر مع الوقت، فلا تكررها هذه الصفحة.
أين ترى استهلاكك#
- إدارة الحصص في تطبيقاتي: بطاقة لكل اشتراك نشط، بشريط وأرقام وعلامة عند 80%. العلامة هي موضع التنبيه لا موضع نفاد الحصة.
- عرض الاستخدام في اشتراكاتي، على اشتراك مسعَّر لكل نقطة نهاية: الوحدات المستخدمة والمشتراة لكل نقطة نهاية في الدورة الحالية، وطريقة لشحن الحصة.
- الاحصائيات في صفحة التطبيق: إجمالي استدعاءات التطبيق والمنتجات التي استدعاها ونسبة أخطائه، في المدة التي تختارها.
- الرد نفسه، في نقطة نهاية لها قاعدة حصة: الترويسات أدناه.
ترويسات في نقاط النهاية التي تُطبَّق عليها حصة#
تعيد نقطة النهاية التي لها قاعدة حصة عدّاداتها في كل رد:
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.