दर सीमाएँ और सर्वर त्रुटियाँ सँभालें

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 का मान कभी लॉग न करें। कुछ सीमित प्रयासों के बाद स्वचालित पुनः प्रयास रोकें और विफलता समीक्षा के लिए दिखाएँ।