跳转到内容

తప్పులు మరియు పునఃప్రయత్నాలు

వ్యాపార తప్పిదాలు స్పందన శరీరం యొక్క అత్యధిక స్థాయిలో code మరియు message ను తిరిగి ఇస్తాయి. detail సాధారణంగా message వలెనే ఉంటుంది, కానీ దీనికి భిన్నమైన, సంక్షిప్త వివరణ (క్రింది విధంగా) ఉండవచ్చు; వినియోగదారులకు 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 రిస్పాన్స్ హెడర్‌ను నమోదు చేయండి.

స్థితిఅర్థంసలహా
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())