حدود المعدل والإصدارات

تكشف الاستجابات المصادق عليها x-ratelimit-limit وx-ratelimit-remaining وx-ratelimit-reset؛ قد تقوم بعض الطرق الخاضعة للحراسة أيضًا بإرجاع Retry-After. يمكن أن تكون القيمة الحدية ديناميكية أو يتم الإبلاغ عنها كـ unlimited.

1. قم بتسجيل الحالة ورمز الخطأ وx-request-id.
2. في 429، انتظر حتى ظهور Retry-After أو x-ratelimit-reset.
3. أعد المحاولة مع التراجع الأسي، والارتعاش، والحد الأقصى للتأخير، والحد الأقصى لعدد المحاولات.
4. قم بوضع حد لتزامن العميل بدلاً من إطلاق عاصفة إعادة المحاولة.
5. لا تقم بإعادة محاولة العمل غير الفعال ما لم يوثق المسار سلوك إعادة التشغيل الآمن.

احتفظ بـ /v1 في المسار الأساسي واختبر عمليات الترحيل مقابل الوثائق قبل تغييرها؛ لا يلزم وجود رأس إصدار عام بديل للمسارات الحالية.

النتيجة المتوقعة: يتعافى العملاء من الحدود المؤقتة دون تكرار العمل ويفشلون بشكل واضح في المسارات غير المتوافقة.