त्रुटियाँ और पुनः प्रयास
व्यापारिक त्रुटियाँ प्रतिक्रिया बॉडी के शीर्ष स्तर पर code और message लौटाती हैं। detail आमतौर पर message के समान होता है, लेकिन यह एक अलग, संक्षिप्त सjjasj (नीचे के अनुसार) हो सकता है; उपयोगकर्ताओं को message प्रदर्शित करें। संदेश चीनी में हैं:
{ "code": "CONCURRENCY_LIMITED", "message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交", "detail": "排队文件完成一部分后可继续提交"}कुछ व्यवसायिक त्रुटियाँ केवल code लौटाती हैं। सत्यापन विफलताएँ detail में फ़ील्ड त्रुटियों की सूची के साथ 422 लौटाती हैं:
{ "detail": [ { "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" } ]}त्रुटियों को पहले HTTP स्थिति से और फिर code से हैंडल करें: कई त्रुटियाँ केवल सामान्य UNKNOWN_ERROR लौटाती हैं, और केवल कुछ ही एक विशिष्ट code ले जाती हैं (जैसे नीचे दिए गए 429 मामले)। ट्रबलशूटिंग के लिए X-Request-Id प्रतिक्रिया हेडर को रिकॉर्ड करें।
HTTP स्थिति
Section titled “HTTP स्थिति”| स्थिति | अर्थ | सलाह |
|---|---|---|
400 | अमान्य अनुरोध, उदाहरण के लिए चयनित सेटिंग उपलब्ध नहीं है | अनुरोध को ठीक करें; पुनः प्रयास न करें |
401 | क्रेडेंशियल गायब, अमान्य, समाप्त हो चुका या रद्द कर दिया गया है | शिक्षाप्रद जानकारी बदलें |
402 | शेष (ऋण के बाद) नौकरी के थ्रेशोल्ड से ऊपर नहीं है, या यह ऋणात्मक है; एक API कुंजी के साथ, कुंजी का शेष बजट बहुत कम हो सकता है। | टॉप अप (या की का बजट बढ़ाएं), फिर से सबमिट करें |
403 | कुंजी की सीमाएँ इस संचालन की अनुमति नहीं देतीं (उदाहरण के लिए, अनुवाद सेटिंग अनुमत नहीं है), खाता अक्षम है, या यह संचालन एक साइन-इन ब्राउज़र में किया जाना चाहिए (जैसे कि API कुंजियों का प्रबंधन) | की-सेटिंग्स की जाँच करें या वेबसाइट का उपयोग करें |
404 | संसाधन मौजूद नहीं है, इसे हटा दिया गया है या यह किसी अन्य खाते से संबद्ध है (ये तीनों समान प्रतीत होते हैं) | ID जांचें |
409 | इडेम्पोटेंसी कुंजी का उपयोग किसी अन्य अनुरोध के लिए किया गया था, या संसाधन की स्थिति ऑपरेशन की अनुमति नहीं देती है | मूल संचालन को पूछें, फिर निर्णय लें |
410 | संसाधन या एंडपॉइंट परमानेंट रूप से अनुपलब्ध है, उदाहरण के लिए, एक सेवानिवृत्त एंडपॉइंट या एक आइडेम्पोटेंसी की के पीछे डिलीट किया गया जॉब। | पुनः प्रयास न करें |
413 | फ़ाइल या अनुरोध बॉडी सीमा से अधिक है | एक छोटी फ़ाइल का उपयोग करें |
415 | असमर्थित फ़ाइल प्रारूप | किसी अन्य प्रारूप का उपयोग करें |
422 | सत्यापन विफल हुआ, या फ़ाइल खाली है या प्रोसेस करने के लिए कुछ नहीं है | फ़ील्डों को ठीक करें; स्वचालित रूप से पुनः प्रयास न करें |
429 | दर, कतार का आकार या बजट सीमित है | नीचे देखें |
5xx | अस्थायी सेवा त्रुटि | अधिकतम प्रयासों की संख्या के साथ घातीय बैकऑफ़ |
429 का हैंडलिंग
Section titled “429 का हैंडलिंग”code | अर्थ | क्या करें |
|---|---|---|
RATE_LIMITED | अत्यधिक अनुरोध | Retry-After की प्रतीक्षा करें, फिर पुनः प्रयास करें |
CONCURRENCY_LIMITED | बहुत सारे फ़ाइल अनुवाद कार्य लंबित हैं | Retry-After का या कुछ जॉब्स पूरे होने का इंतजार करें |
AUTH_API_KEY_QUOTA_EXCEEDED | की का बजट समाप्त हो गया है | बजट बढ़ने तक पुनः प्रयास न करें |
Retry-After के बिना 429 को एक्सपोनेंशियल बैकऑफ़ के साथ हैंडल किया जाना चाहिए।
पुनः प्रयास रणनीति
Section titled “पुनः प्रयास रणनीति”- क्वेरी को सीधे दोबारा भेजा जा सकता है।
- क्रिएट रिक्वेस्ट को दोबारा भेजते समय, उसी
Idempotency-Keyऔर बिल्कुल वही बॉडी का उपयोग करें; हर नए सबमिशन के लिए एक नया की इस्तेमाल करें। - असफल अपलोड के बाद, नया अपलोड पता मांगें।
- प्रत्येक अनुरोध के लिए कनेक्ट, रीड और कुल टाइमआउट सेट करें, पुनः प्रयासों में यादृच्छिक जिटर जोड़ें, और प्रयासों की संख्या की सीमा निर्धारित करें।
import randomimport time
for attempt in range(5): response = call_api() if response.status_code not in {429, 500, 502, 503, 504}: break if response.status_code == 429 and response.json().get("code") == "AUTH_API_KEY_QUOTA_EXCEEDED": break retry_after = response.headers.get("Retry-After") delay = float(retry_after) if retry_after else min(2 ** attempt, 16) time.sleep(delay + random.random())