عندما يعيد API الحالة 429، قد تجعل إعادة المحاولة الفورية المشكلة أكبر: كل عميل يرسل طلبًا جديدًا في اللحظة نفسها، فيزداد الضغط بدل أن يهدأ. تحتاج معالجة الحدود إلى عقد واضح بين الخادم والعميل، وميزانية انتظار ومحاولات، ورسالة تفهم منها فرق الدعم ما الذي توقف ولماذا.
اعرف ما الذي يحسبه الحد
تحدد RFC 6585 معنى 429 باعتباره تجاوزًا لعدد الطلبات خلال فترة، وتسمح بإضافة Retry-After. لكنها لا تفرض طريقة موحدة لتعريف المستخدم أو عد الطلبات. اطلب من مزود التكامل توضيح هل الحد للحساب، أم المفتاح، أم المسار، أم عنوان الشبكة.
هذا التمييز مهم في منصة متعددة العملاء. إذا ربط العميل حدًا خاصًا بمستخدم واحد بطابور عالمي، قد يوقف عمل الآخرين دون سبب. وفي الاتجاه المقابل، توزيع الطلبات على عدة عمال لا يزيد الحد المتفق عليه للحساب نفسه. اختبر نطاق العزل ببيانات تجريبية بدل استنتاجه من رقم الاستجابة وحده.
اكتب ميزانية إعادة المحاولة
توضح دلالة Retry-After في HTTP أنه قد يحمل عدد ثوانٍ أو تاريخ HTTP. يجب أن يفسره العميل وفق الصيغة الصحيحة. إذا كانت القيمة غائبة أو غير صالحة، حدد سياسة انتظار محدودة ومتزايدة تناسب الخدمة، ويمكن إضافة تباين عشوائي لتجنب استيقاظ جميع العملاء معًا.
| جزء الميزانية | قرار مطلوب من الفريق |
|---|---|
| عدد المحاولات | حد يتوقف بعده التنفيذ بوضوح |
| الزمن الكلي | مهلة مناسبة للعملية لا لكل طلب فقط |
| تكرار الأثر | تحقق قبل إعادة عملية تغير البيانات |
| إلغاء المستخدم | إيقاف الانتظار وعدم بدء محاولة جديدة |
اختبر الحد بخادم تجريبي
جهز ردودًا مصطنعة: 429 مع ثوانٍ، ثم مع تاريخ، ثم دون الترويسة، ثم نجاح بعد انتظار. راقب أوقات الطلبات وعددها، وتأكد من أن تحديث الصفحة لا ينشئ سلسلة محاولات مستقلة للعملية نفسها. لا تضغط على خدمة إنتاج لطرف آخر لاكتشاف حدودها.
في سيناريو افتراضي لاستيراد سجلات، احتفظ بآخر نقطة مؤكدة ومعرفات العناصر المعالجة. بعد انتهاء الميزانية، اعرض أن المهمة متوقفة أو مؤجلة مع وسيلة استئناف معلومة. لا تعرض نجاحًا كاملًا بعد استيراد جزء فقط، ولا تعاود إرسال عمليات تغيير البيانات دون فهم ما إذا كان أثر المحاولة السابقة قد حدث.
راقب السبب والنتيجة
سجل اسم التكامل ونطاق الحد وعدد المحاولات وزمن الانتظار مع إخفاء مفاتيح API والبيانات الشخصية. ضمن مراجعة التكاملات اختبر أن حسابًا محدودًا لا يعطل بقية الحسابات، واتفق مع فريق الصيانة على إجراء عند تكرر الحالة. المعالجة الجيدة تخفف الضغط وتحافظ على معنى حالة العملية؛ زيادة عدد المحاولات بلا سقف ليست حلًا للحدود.
