Přeskočit na obsah

Chyby a opakované pokusy

Chyby v obchodních operacích vracejí code a message na nejvyšší úrovni těla odpovědi. detail je obvykle stejný jako message, ale může být jiný, kratší popis (jak je uvedeno níže); uživatelům zobrazte message. Zprávy jsou v čínštině:

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

Některé chyby v obchodních transakcích vracejí pouze code. Chyby ověřování vracejí 422 s seznamem chyb polí v detail:

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

Chyby řešte nejprve podle stavu HTTP, poté podle code: mnoho chyb vrací pouze univerzální UNKNOWN_ERROR a pouze některé obsahují konkrétní code (například 429 případů uvedených níže). Pro diagnostiku zaznamenejte hlavičku odpovědi X-Request-Id.

StavVýznamRady
400Neplatná žádost, například zvolené nastavení není k dispozici.Opravte požadavek; nezkoušejte znovu
401Přihlašovací údaje chybí, jsou neplatné, vypršely nebo byly zrušeny.Změňte přihlašovací údaje
402Zůstatek (po odečtení dluhu) nepřesahuje prahovou hodnotu pro danou úlohu, nebo je záporný; v případě klíče API může být zbývající rozpočet klíče příliš nízký.Doplňte (nebo zvýšte rozpočet klíče) a pak odešlete znovu.
403Hranice klíče tuto operaci neumožňují (například nastavení překladu není povoleno), účet je deaktivován nebo musí být operace provedena v prohlížeči s přihlášeným účtem (například správa API klíčů).Zkontrolujte klíčová nastavení nebo použijte webovou stránku
404Zdroj neexistuje, byl smazán nebo patří jinému účtu (všechny tři případy vypadají stejně)Zkontrolujte ID
409Klíč idempotence byl použit pro jinou žádost, nebo stav zdroje neumožňuje tuto operaci.Dotaz na původní operaci, poté rozhodněte
410Zdroj nebo koncová bod je trvale odstraněn, například koncevý bod, který byl zrušen, nebo smazaný úloha spjatá s klíčem idempotence.Nezkoušet znovu
413Soubor nebo tělo požadavku překračuje limitPoužijte menší soubor
415Nepodporovaný formát souboruPoužijte jiný formát
422Validace selhala, nebo je soubor prázdný či neobsahuje žádné data k zpracování.Opravte pole; nezkoušejte automaticky znovu
429Sazba, velikost fronty nebo rozpočet jsou omezenéViz níže
5xxDočasná chyba službyExponenciální zpomalování s maximálním počtem pokusů
codeVýznamCo dělat
RATE_LIMITEDPříliš mnoho požadavkůPočkejte na Retry-After a pak zopakujte pokus.
CONCURRENCY_LIMITEDVe frontě je příliš mnoho úloh na překlad souborů.Počkejte na Retry-After nebo dokud některé úlohy nedokončí.
AUTH_API_KEY_QUOTA_EXCEEDEDRozpočet klíče je vyčerpánNezkoušejte znovu, dokud nebude zvýšen rozpočet.

A 429 bez Retry-After by měl být zpracován s exponenciálním opožděním.

  • Dotazy lze přímo zopakovat.
  • Při opakovaném pokusu o vytvoření požadavku použijte stejný Idempotency-Key a přesně stejný text těla; pro každé nové odeslání použijte nový klíč.
  • Po neúspěšném nahrání požádejte o novou adresu pro nahrávání.
  • Nastavte časové limity připojení, čtení a celkové pro každou požadavku, přidejte náhodné zpoždění do opakovaných pokusů a omezte počet pokusů.
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())