跳转到内容

പിശകുകളും ആവർത്തനങ്ങളും

ബിസിനസ്സ് പിശകുകൾ പ്രതികരണ ബോഡിയുടെ ഉയർന്ന തലത്തിൽ 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കീയുടെ പരിധികൾ ഈ പ്രവർത്തനത്തെ അനുവദിക്കുന്നില്ല (ഉദാഹരണത്തിന് വിവർത്തന ക്രമീകരണം അനുവദനീയമല്ല), അക്കൗണ്ട് അപ്രാപ്‌തമാക്കി അല്ലെങ്കിൽ സൈൻ ഇൻ ചെയ്‌ത ബ്രൗസറിൽ പ്രവർത്തനം നടത്തണം (എപിഐ കീകൾ കൈകാര്യം ചെയ്യുന്നത് പോലുള്ളവ)പ്രധാന ക്രമീകരണങ്ങൾ പരിശോധിക്കുക അല്ലെങ്കിൽ വെബ്സൈറ്റ് ഉപയോഗിക്കുക
404ഉറവിടം നിലവിലില്ല, ഇല്ലാതാക്കി അല്ലെങ്കിൽ മറ്റൊരു അക്കൗണ്ടിൻ്റെ ഉടമസ്ഥതയിലുള്ളതാണ് (മൂന്നും ഒരുപോലെ കാണപ്പെടുന്നു)ഐഡി പരിശോധിക്കുക
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 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())