తప్పులు మరియు పునఃప్రయత్నాలు
వ్యాపార తప్పిదాలు స్పందన శరీరం యొక్క అత్యధిక స్థాయిలో 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 రిస్పాన్స్ హెడర్ను నమోదు చేయండి.
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())