跳转到内容

பிழைகள் மற்றும் மீண்டும் முயற்சிகள்

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