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