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.
Stav HTTP
Section titled “Stav HTTP”| Stav | Význam | Rady |
|---|---|---|
400 | Neplatná žádost, například zvolené nastavení není k dispozici. | Opravte požadavek; nezkoušejte znovu |
401 | Přihlašovací údaje chybí, jsou neplatné, vypršely nebo byly zrušeny. | Změňte přihlašovací údaje |
402 | Zů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. |
403 | Hranice 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 |
404 | Zdroj neexistuje, byl smazán nebo patří jinému účtu (všechny tři případy vypadají stejně) | Zkontrolujte ID |
409 | Klíč idempotence byl použit pro jinou žádost, nebo stav zdroje neumožňuje tuto operaci. | Dotaz na původní operaci, poté rozhodněte |
410 | Zdroj 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 |
413 | Soubor nebo tělo požadavku překračuje limit | Použijte menší soubor |
415 | Nepodporovaný formát souboru | Použijte jiný formát |
422 | Validace selhala, nebo je soubor prázdný či neobsahuje žádné data k zpracování. | Opravte pole; nezkoušejte automaticky znovu |
429 | Sazba, velikost fronty nebo rozpočet jsou omezené | Viz níže |
5xx | Dočasná chyba služby | Exponenciální zpomalování s maximálním počtem pokusů |
Zpracování 429
Section titled “Zpracování 429”code | Význam | Co dělat |
|---|---|---|
RATE_LIMITED | Příliš mnoho požadavků | Počkejte na Retry-After a pak zopakujte pokus. |
CONCURRENCY_LIMITED | Ve 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_EXCEEDED | Rozpočet klíče je vyčerpán | Nezkouš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.
Strategie opakovaných pokusů
Section titled “Strategie opakovaných pokusů”- Dotazy lze přímo zopakovat.
- Při opakovaném pokusu o vytvoření požadavku použijte stejný
Idempotency-Keya 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 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())