பிழைகள் மற்றும் மீண்டும் முயற்சிகள்
வணிகப் பிழைகள் பதில் உடலின் மேல்நிலையில் 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 | இடம்பெயர்தல் விசை வேறு கோரிக்கைக்காகப் பயன்படுத்தப்பட்டது அல்லது வளத்தின் நிலை செயல்பாட்டை அனுமதிக்கவில்லை | மூல செயல்பாட்டை வினவி, பின்னர் முடிவெடுக்கவும் |
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())