حدود المعدّل

تحافظ الحدود على سرعة واجهة البرمجة للجميع. وهي تحسب الطلبات ضمن نوافذ زمنية ثابتة، لكل مفتاح ولكل حساب.

حدود الطلبات

ينطبق على	الحد
كل مفتاح لواجهة البرمجة	120 طلبًا كل 60 ثانية
كل مفاتيح الحساب مجتمعة	300 طلبًا كل 60 ثانية

الترويسات

تحمل كل استجابة لمفتاح واجهة البرمجة الحدَّ الأضيق من الاثنين:

RateLimit-Limit: عدد الطلبات المسموح بها في النافذة الحالية.
RateLimit-Remaining: عدد الطلبات المتبقية في النافذة الحالية.
RateLimit-Reset: عدد الثواني حتى إعادة ضبط النافذة.
RateLimit-Policy: الحد والنافذة، مثل 120;w=60.

عند تجاوز الحد تتلقى 429 مع الرمز rate_limited والترويسة Retry-After: انتظر هذا العدد من الثواني قبل إعادة المحاولة.

HTTP

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json
RateLimit-Limit: 120
RateLimit-Remaining: 0
RateLimit-Reset: 17
RateLimit-Policy: 120;w=60
Retry-After: 17

عمليات التوليد المتزامنة

بمعزل عن حدود الطلبات، تعمل 4 عمليات توليد في الوقت نفسه لكل حساب (8 بعد أول عملية شراء للعملات). يمكنك إرسال المزيد: تنتظر عمليات التوليد الإضافية في الطابور وتبدأ عندما تنتهي غيرها. تعرض GET /v1/generations/concurrency الحد وعدد العمليات التي تعمل أو تنتظر الآن.

لا تستعلم عن عملية توليد أسرع من مرة كل ثانيتين، أو استخدم خطافات الويب بدلًا من ذلك.