حدود معدل الطلبات
Engine ≥ 4.143.0. تتضمن كل استجابة للرمز data.rate_limits من سياسة المتجر وقت إصداره. تتشارك جميع المفاتيح هذه الحدود؛ إصدار رمز جديد لا يعيد ضبطها. قد يسري تغيير الخطة قبل انتهاء صلاحية الرمز.
- read_per_minute
- طلبات القراءة في الدقيقة.
- write_per_minute
- طلبات الكتابة في الدقيقة؛ لا تمنح هذه القيمة صلاحيات الكتابة.
- auth_per_minute
- طلبات الرمز في الدقيقة، بما فيها محاولات المصادقة الفاشلة.
وزّع الطلبات بالتساوي عبر الزمن؛ عند وجود حد قراءة موجب، اترك بين القراءات فاصلاً بالثواني يساوي 60 مقسومة على read_per_minute على الأقل. لا يضمن الحد قبول هذا العدد من الطلبات المتزامنة. تتشاركه تكاملات أخرى: تعامل مع 429 وRetry-After.
الصفر يعني عدم الإتاحة، وليس الاستخدام غير المحدود.
الحدود في الدقيقة
| متاح بدءًا من | قراءة · GET |
|---|---|
| BASIC | 60 |
| STANDARD | 120 |
| PROFESSIONAL | 300 |
| ADVANCED | 900 |
- كتابة
- 10
- المصادقة
- 10
تشترك جميع مفاتيح المتجر نفسه في هذه الحدود.
الطلب
- تخضع حركة القراءة والكتابة لسياسة API الحالية للمتجر.
- لا توفر المفاتيح سعة غير محدودة مستقلة.
- حدّد التزامن، وخزّن البيانات المرجعية مؤقتًا عند الحاجة، وتجنب جلب تفاصيل لم تتغير بصورة متكررة.
429 · Retry-After
- عندما تعيد API الحالة 429 مع rate_limit.exceeded، انتظر على الأقل عدد الثواني المحدد في Retry-After وأضف تفاوتًا عشوائيًا قبل إعادة المحاولة.
- 429 · capacity.queue_full — قائمة الانتظار القصيرة لواجهة API ممتلئة؛ لم يبدأ تنفيذ الطلب. 429 · capacity.wait_timeout — انتهت مهلة الانتظار في قائمة واجهة API؛ لم يبدأ تنفيذ الطلب. انتظر على الأقل عدد الثواني في Retry-After وأضف تفاوتًا عشوائيًا. احتفظ بالمفتاح والمحتوى الأصليين عند إعادة الكتابة.
- استخدم رمز الخطأ والترويسة الموثقين بدلًا من افتراض فترة انتظار ثابتة.