رفتار کی حد اور سرور کی خرابیوں سے نمٹیں

429 جواب سے نمٹیں

رفتار کی حد سے متاثر درخواست 429 Too Many Requests واپس دیتی ہے اور detail.status کی قدر rate_limit_exceeded ہوتی ہے۔ دوبارہ کوشش سے پہلے جواب کے ہیڈر پڑھیں:

• Retry-After رد شدہ درخواست کے لیے سیکنڈ میں کم سے کم انتظار بتاتا ہے۔
• X-RateLimit-Limit درخواستوں کے مجموعے کی حد بتاتا ہے۔
• X-RateLimit-Remaining باقی درخواستوں کی تعداد بتاتا ہے۔
• X-RateLimit-Reset حد دوبارہ مقرر ہونے کا وقت بتاتا ہے۔

Retry-After تک انتظار کریں، پھر بڑھتے ہوئے وقفے اور معمولی بے قاعدہ تاخیر کے ساتھ دوبارہ کوشش کریں۔ بیک وقت درخواستیں کم کریں اور حد بحال ہوتے ہی بڑی تعداد میں بھیجنے کے بجائے کام قطار میں رکھیں۔

سرور کی خرابیوں سے نمٹیں

500 جواب کا عوامی متن عمومی خرابی اور request_id دکھاتا ہے؛ اندرونی استثنا کی تفصیلات واپس نہیں آتیں۔ 503 کسی ضروری سروس کے عارضی طور پر غیر دستیاب ہونے کی نشان دہی کر سکتا ہے۔

صرف پڑھنے والی درخواستیں محدود بڑھتی تاخیر سے دوبارہ چلائیں۔ بنانے، تازہ کرنے، ادائیگی یا حالت بدلنے والی دوسری درخواست دہرانے سے پہلے معلوم کریں کہ پہلی کوشش مکمل ہوئی تھی یا نہیں۔ وقت ختم ہونا یا 5xx جواب تبدیلی کی ناکامی ثابت نہیں کرتا؛ فوری تکرار کام دوبارہ انجام دے سکتی ہے۔

تشخیصی معلومات محفوظ رکھیں

وقت، طریقہ، راستہ، حالت، جواب کا متن اور X-Request-Id درج کریں۔ x-api-key کی قدر کبھی لاگ نہ کریں۔ محدود تعداد کی کوششوں کے بعد خودکار تکرار روک کر خرابی جائزے کے لیے سامنے لائیں۔