त्रुटी आणि पुन्हा प्रयत्न
व्यवसाय त्रुटी प्रतिसाद शरीराच्या शीर्ष स्तरावर code आणि message परत करतात. detail सहसा message सारखेच असते, परंतु ते वेगळे, छोटे स्पष्टीकरण असू शकते (खाली दर्शविल्याप्रमाणे); वापरकर्त्यांना message दर्शवा. संदेश चिनी भाषेत आहेत:
{ "code": "CONCURRENCY_LIMITED", "message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交", "detail": "排队文件完成一部分后可继续提交"}काही व्यवसाय त्रुटी केवळ code परत करतात. पडताळणी अयशस्वी झाल्यास 422 परत केले जाते, ज्यामध्ये detail मधील फिल्ड त्रुटींची यादी असते:
{ "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 | idempotency की वेगळ्या विनंतीसाठी वापरण्यात आली होती, किंवा संसाधनाची स्थिती ऑपरेशनला परवानगी देत नाही | मूळ ऑपरेशनची क्वेरी करा, त्यानंतर निर्णय घ्या |
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())