تستخدم الطلبات نافذة حساب واحدة متحركة مدتها 60 ثانية تشترك فيها كل المفاتيح. تحدد قيمة الإنفاق الناجح المحتفظ بها مدى الحياة فئة الحساب، وقد ترفض ضوابط عنوان IP والإجراء الطلب قبلها أو بصورة مستقلة. لا توجد حصة بالساعة أو لكل مفتاح.
20,000 طلب / دقيقة / عنوان IPيُطبَّق قبل التحقق من المفتاح كي يكون تعداد المفاتيح بالقوة الغاشمة محدودًا. مشترك بين كل المفاتيح خلف عنوان IP نفسه. الافتراضي مضبوط عالميًا وغير قابل للتخصيص من المستخدم.
120–2,400 طلب / 60 ثانية متحركةتستهلك جميع مفاتيح API النشطة في الحساب العداد نفسه. يحدد سلم الإنفاق الناجح مدى الحياة الحد ما لم يوجد تجاوز RPM مباشر.
يعتمد على الإجراءتضيف بعض الإجراءات الحساسة قاعدة حساب أضيق. على سبيل المثال، يقبل cancel عدد 30 طلبًا في الدقيقة لكل حساب، وتبلغ استجابة 429 عن action.
يعتمد التأهل على الإنفاق الناجح المحتفظ به طوال عمر الحساب. تضيف عمليات التسليم المكتملة والجزئية المبلغ الناجح المحتفظ به، وتخفضه المبالغ المستردة اللاحقة. يتحدث الحد الفعلي من الإجمالي المخزن دون مهمة يومية. استخدم action=account_status لقراءة الفئة المكتسبة وRPM الفعلي.
| الفئة | الحد الأدنى للإنفاق مدى الحياة | طلبات / دقيقة |
|---|---|---|
| 0 | $0.00000000 | 120 |
| 1 | $10.00000000 | 300 |
| 2 | $50.00000000 | 600 |
| 3 | $100.00000000 | 900 |
| 4 | $500.00000000 | 1,200 |
| 5 | $1000.00000000 | 1,800 |
| 6 | $2500.00000000 | 2,400 |
| الترويسة | الوصف |
|---|---|
| X-RateLimit-Limit | في الاستجابات العادية، الحد الفعلي المشترك لطلبات الحساب في الدقيقة. وفي استجابة 429، الحد الذي تبلغ عنه طبقة الرفض. |
| X-RateLimit-Remaining | في الاستجابات العادية، الطلبات المتبقية في نافذة الحساب المشتركة. وفي استجابة 429، القيمة المتبقية التي تبلغ عنها طبقة الرفض. |
| X-RateLimit-Reset | عدد نسبي من الثواني حتى إعادة ضبط النافذة المُبلّغ عنها؛ وليس طابعًا زمنيًا بنظام Unix. |
| X-RateLimit-Tier | الفئة المكتسبة من الإنفاق الناجح مدى الحياة (0–6). لا يغيّر تجاوز RPM المخصص هذه القيمة. |
| X-RateLimit-Source | "tier" عندما يحدد السلم الثابت RPM الفعلي، و"custom" عندما يحدده تجاوز مباشر من المشرف. |
| X-RateLimit-DeniedBy | يُرسل مع استجابة 429 عندما يرفض محدد مسمى الطلب: "ip" أو "api_requests_per_minute" أو "action". |
| Retry-After | في استجابة 429 أو 503 القابلة لإعادة المحاولة، انتظر قيمة Retry-After هذه الثواني على الأقل قبل إعادة المحاولة. في action=add، استخدم مفتاح التكرار الآمن نفسه بعد الانتظار. |
ip وapi_requests_per_minute وaction طبقة الرفض؛ ولا يؤدي تغيير المفتاح إلى تجاوز حد الحساب المشترك أو IP أو الإجراء.action=status.