跳转到内容

त्रुटी आणि पुन्हा प्रयत्न

व्यवसाय त्रुटी प्रतिसाद शरीराच्या शीर्ष स्तरावर 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 प्रतिसाद हेडर नोंदवा.

स्थितीअर्थसल्ला
400अवैध विनंती, उदाहरणार्थ निवडलेली सेटिंग अनुपलब्ध आहेविनंती त्रुटीपूर्ण आहे; पुन्हा प्रयत्न करू नका
401憑त्रक गहाळ, अवैध, कालबाह्य झाले आहे किंवा रद्द करण्यात आले आहे憑त्र बदला
402उर्वरित रक्कम (कर्जानंतर) कामाच्या थ्रेशोल्डच्या वर नाही किंवा ती ऋणात्मक आहे; API कीसह, कीचे उर्वरित बजेट खूप कमी असू शकते.टॉप अप (किंवा कीचे बजेट वाढवा), त्यानंतर पुन्हा सबमिट करा
403कीची मर्यादा या ऑपरेशनला परवानगी देत नाही (उदाहरणार्थ, अनुवाद सेटिंग अनुमत नाही), खाते अक्षम केले आहे किंवा हे ऑपरेशन साइन-इन केलेल्या ब्राउझरमध्ये करावे लागते (जसे की API कीज व्यवस्थापित करणे)की परिपालन तपासा किंवा वेबसाइट वापरा
404संसाधन अस्तित्वात नाही, ते हटवण्यात आले आहे किंवा ते दुसऱ्या खात्याचे आहे (हे तिन्ही समान दिसतात)ID तपासा
409idempotency की वेगळ्या विनंतीसाठी वापरण्यात आली होती, किंवा संसाधनाची स्थिती ऑपरेशनला परवानगी देत नाहीमूळ ऑपरेशनची क्वेरी करा, त्यानंतर निर्णय घ्या
410संसाधन किंवा एंडपॉइंट कायमस्वरूपी गायब झाले आहे, उदाहरणार्थ, निवृत्त एंडपॉइंट किंवा इडेम्पोटेन्सी की मागील हटवलेले जॉब.पुन्हा प्रयत्न करू नका
413फाइल किंवा विनंती बॉडी मर्यादेपेक्षा जास्त आहेलहान फाइल वापरा
415असमर्थित फाइल स्वरूपदुसरे स्वरूप वापरा
422पडताळणी अयशस्वी झाली, किंवा फाइल रिकामी आहे किंवा प्रक्रिया करण्यासाठी काहीच नाही.क्षेत्रे दुरुस्त करा; स्वयंचलितपणे पुन्हा प्रयत्न करू नका
429दर, क्यू आकार किंवा बजेट मर्यादितखाली पहा
5xxतात्पुरती सेवा त्रुटीजास्तीत जास्त प्रयत्नांची संख्या असलेले एक्सपोनेंशियल बॅकऑफ
codeअर्थकाय करावे
RATE_LIMITEDअतिशय जास्त विनंत्याRetry-After ची प्रतीक्षा करा, त्यानंतर पुन्हा प्रयत्न करा
CONCURRENCY_LIMITEDफाइल अनुवाद करण्याचे जास्तीत जास्त कार्ये रांगेत आहेतRetry-After पर्यंत थांबा, किंवा काही कामे पूर्ण होण्याची वाट पहा
AUTH_API_KEY_QUOTA_EXCEEDEDकीचे बजेट संपले आहेअर्थसंकल्प वाढेपर्यंत पुन्हा प्रयत्न करू नका

Retry-After नसलेल्या 429 ला एक्सपोनेंशियल बॅकऑफ सह हाताळले पाहिजे.

पुनर्प्रयत्न धोरण

Section titled “पुनर्प्रयत्न धोरण”
  • क्वेरी थेट पुन्हा प्रयत्न करता येतात.
  • नवीन तयार करण्याच्या विनंतीचा पुनर्प्रयत्न करताना, तोच Idempotency-Key आणि अगदी समान बॉडी पुन्हा वापरा; प्रत्येक नवीन सबमिशनसाठी नवीन की वापरा.
  • अपलोड अयशस्वी झाल्यानंतर, नवीन अपलोड पत्ता मागवा.
  • प्रत्येक विनंतीसाठी कनेक्ट, रीड आणि एकूण टाइमआउट सेट करा, पुन्हा प्रयत्नांमध्ये यादृच्छिक जिटर जोडा आणि प्रयत्नांची संख्या मर्यादित करा.
import random
import 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())