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

تعامل مع `/v1` باعتباره عقد المسار الحالي واستخدم رؤوس الاستجابة بدلاً من حدود الطلب المضمنة.

تكشف الاستجابات المصادق عليها `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` في المسار الأساسي واختبر عمليات الترحيل مقابل الوثائق قبل تغييرها؛ لا يلزم وجود رأس إصدار عام بديل للمسارات الحالية.

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