Preskočiť na obsah

Chyby a opakované pokusy

Chyby v podnikaní vrátia code a message na najvyššej úrovni tela odpovede. detail je zvyčajne rovnaký ako message, ale môže byť iný, kratší vysvetlením (ako je uvedené nižšie); používateľom zobrazte message. Správy sú v čínštine:

{
"code": "CONCURRENCY_LIMITED",
"message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交",
"detail": "排队文件完成一部分后可继续提交"
}

Niektoré obchodné chyby vrátia iba code. Chyby overovania vrátia 422 so zoznamom chýb polí v detail:

{
"detail": [
{ "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" }
]
}

Spracujte chyby najskôr podľa stavu HTTP a potom podľa code: mnoho chýb vracia iba univerzálny kód UNKNOWN_ERROR, a len niektoré obsahujú špecifický code (ako napríklad 429 prípadov uvedených nižšie). Zaznamenajte hlavičku odpovede X-Request-Id na pomoc pri riešení problémov.

StavVýznamRady
400Neplatná požiadavka, napríklad zvolené nastavenie nie je dostupné.Opravte požiadavku; neopakujte pokus
401Poverenie chýba, je neplatné, vypršalo alebo bolo zrušené.Zmeňte poverenie
402Zostatok (po odpočítaní dlhu) neprekračuje prahovú hodnotu pre úlohu alebo je záporný; v prípade API kľúča môže byť zostatkový rozpočet kľúča príliš nízky.Doplňte (alebo zvýšte rozpočet kľúča) a potom odoslať znova.
403Hranice kľúča neumožňujú túto operáciu (napríklad nie je povolené nastavenie prekladu), účet je zakázaný alebo musí byť operácia vykonaná v prihlásenom prehliadači (napríklad správa API kľúčov).Skontrolujte kľúčové nastavenia alebo použite webovú stránku
404Zdroj neexistuje, bol odstránený alebo patrí inej účtovnej skupine (všetky tri možnosti vyzerajú rovnako)Skontrolujte ID
409Kľúč idempotencie bol použitý pre inú požiadavku, alebo stav zdroja neumožňuje túto operáciu.Query pôvodnú operáciu a potom rozhodnite
410Zdroj alebo koncová bod je natrvalo neexistujúci, napríklad nepoužívaný koncový bod alebo odstránená úloha spätne viazaná na idempotentný kľúč.Neopakujte pokus
413Súbor alebo telo požiadavky presahuje limitPoužite menší súbor
415Nepodporovaný formát súboruPoužite iný formát
422Validácia zlyhala alebo je súbor prázdny alebo neobsahuje žiadne dáta na spracovanie.Opravte polia; neopakujte automaticky
429Rýchlosť, veľkosť fronty alebo rozpočet sú obmedzenéPozrite si nižšie
5xxDočasná chyba službyExponenciálna pauza s maximálnym počtom pokusov
codeVýznamČo robiť
RATE_LIMITEDPríliš veľa žiadostíPočkajte na Retry-After a potom skúste znova
CONCURRENCY_LIMITEDV poradí je príliš veľa úloh na preklad súborov.Počkajte na Retry-After alebo na ukončenie niektorých úloh.
AUTH_API_KEY_QUOTA_EXCEEDEDRozpočet kľúča je vyčerpaný.Neopakujte pokus, kým nebude zvýšený rozpočet.

A 429 bez Retry-After by malo byť spracované s exponenciálnym spätným odpočítavaním.

  • Dotazy je možné priamo opakovať.
  • Pri opakovanom pokuse o vytvorenie požiadavky použite rovnaký Idempotency-Key a presne rovnaké telo; pre každé nové odoslanie použite nový kľúč.
  • Po neúspešnom nahratí požiadajte o novú adresu na nahrávanie.
  • Nastavte časové limity pripojenia, čítania a celkové časové limity pre každú požiadavku, pridajte náhodný jitter k opakovaným pokusom a obmedzte počet pokusov.
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())