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.
HTTP stav
Section titled “HTTP stav”| Stav | Význam | Rady |
|---|---|---|
400 | Neplatná požiadavka, napríklad zvolené nastavenie nie je dostupné. | Opravte požiadavku; neopakujte pokus |
401 | Poverenie chýba, je neplatné, vypršalo alebo bolo zrušené. | Zmeňte poverenie |
402 | Zostatok (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. |
403 | Hranice 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 |
404 | Zdroj neexistuje, bol odstránený alebo patrí inej účtovnej skupine (všetky tri možnosti vyzerajú rovnako) | Skontrolujte ID |
409 | Kľúč 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 |
410 | Zdroj 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 |
413 | Súbor alebo telo požiadavky presahuje limit | Použite menší súbor |
415 | Nepodporovaný formát súboru | Použite iný formát |
422 | Validácia zlyhala alebo je súbor prázdny alebo neobsahuje žiadne dáta na spracovanie. | Opravte polia; neopakujte automaticky |
429 | Rýchlosť, veľkosť fronty alebo rozpočet sú obmedzené | Pozrite si nižšie |
5xx | Dočasná chyba služby | Exponenciálna pauza s maximálnym počtom pokusov |
Spracovanie 429
Section titled “Spracovanie 429”code | Význam | Čo robiť |
|---|---|---|
RATE_LIMITED | Príliš veľa žiadostí | Počkajte na Retry-After a potom skúste znova |
CONCURRENCY_LIMITED | V 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_EXCEEDED | Rozpoč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.
Stratégia opakovaných pokusov
Section titled “Stratégia opakovaných pokusov”- Dotazy je možné priamo opakovať.
- Pri opakovanom pokuse o vytvorenie požiadavky použite rovnaký
Idempotency-Keya 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 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())