الحصص وحدود المعدل
تحكم الحصص قاعدة واحدة: كل جلسة التقاط محتسبة محاولة واحدة، أياً كان مصيرها. وتُنفق المحاولة عند إنشاء الجلسة.
GET
/v1/usage- تُحتسب جلسات الإنتاج، بما فيها المرفوضة والمعادة والمتروكة.
- في خطة المطوّر تُحتسب الجلسات التجريبية أيضاً، لأن البيئة التجريبية هي كل ما في هذه الخطة. ولا تُحتسب في الخطط المدفوعة.
- عند نفاد المحاولات تعيد الجلسات الجديدة 429 quota_exceeded حتى الفترة التالية.
- لا تفرض وركاء رسوم تجاوز تلقائياً.
- تصلك رسالة وحدث usage.threshold عند 80% و100%.
حدود المعدل
تُطبق الحدود لكل مؤسسة وبيئة، فتتشاركها جميع مفاتيحك واستدعاءاتك. ولا تضيف المفاتيح الإضافية سعة. وتقتصر البيئة التجريبية على 5 طلبات في الثانية، أو أقل إذا كانت خطتك أقل. وتستهلك عملية التحقق الواحدة استدعاءين محدودين: إنشاء الجلسة والتحقق. أما رفع الإطارات فيستخدم رمز الالتقاط ولا يُحتسب. وتحمل كل استجابة لطلب بمفتاح API الترويسات أدناه.
| الترويسة | المعنى |
|---|---|
| X-RateLimit-Limit | الطلبات المسموحة في هذه النافذة |
| X-RateLimit-Remaining | الطلبات المتبقية |
| X-RateLimit-Reset | وقت انتهاء النافذة بنظام Unix |
| Retry-After | ثوانٍ للانتظار، مع 429 و503 |
تعني الاستجابة 503 overloaded أن الخدمة بلغت طاقتها. تبقى الجلسة قابلة للاستخدام، فانتظر Retry-After واستدع التحقق مجدداً.