Pogreške i ponovni pokušaji
Poslovne greške vraćaju code i message na najvišoj razini tijela odgovora. detail obično je isti kao message, ali može biti druga, kraća objašnjenja (kao u nastavku); korisnicima prikažite message. Poruke su na kineskom jeziku:
{ "code": "CONCURRENCY_LIMITED", "message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交", "detail": "排队文件完成一部分后可继续提交"}Neke poslovne greške vraćaju samo code. Neuspjesi valideacije vraćaju 422 s popisom grešaka polja u detail:
{ "detail": [ { "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" } ]}Prvo obradite greške prema statusu HTTP, a zatim prema code: mnoge greške vraćaju samo opći kod UNKNOWN_ERROR, a samo neke sadrže specifični code (kao što su 429 slučajeva u nastavku). Zabilježite zaglavlje odgovora X-Request-Id za rješavanje problema.
HTTP status
Section titled “HTTP status”| Status | Značenje | Savjeti |
|---|---|---|
400 | Nevaljana zahtjev, primjerice odabrano postavljanje nije dostupno | Popravite zahtjev; ne pokušavajte ponovno |
401 | Poverenica nedostaje, nije valjana, istekla je ili je opozvana | Promijenite vjerodajnice |
402 | Saldo (nakon dugova) nije iznad pragova za posao ili je negativan; uz API ključ, preostali budžet ključa može biti prenizak. | Pobrinite se za dovršetak (ili povećajte budžet ključa), a zatim ponovno pošaljite. |
403 | Ograničenja ključa ne dopuštaju ovu operaciju (na primjer, postavka prevoda nije dopuštena), račun je onemogućen ili se operacija mora izvršiti u pregledniku s prijavljenim korisničkim računom (kao što je upravljanje API ključevima) | Provjerite ključne postavke ili koristite web-mjesto |
404 | Resurs ne postoji, izbrisan je ili pripada drugom računu (sva tri izgledaju isto) | Provjerite ID |
409 | Ključ idempotencije korišten je za drugačiji zahtjev ili stanje resursa ne dopušta operaciju. | Query originalnu operaciju, a zatim odlučite |
410 | Resurs ili krajnja točka trajno je nestao, primjerice povučena krajnja točka ili izbrisani zadatak povezan s ključem idempotencije. | Ne ponavljajte pokušaj |
413 | Datoteka ili tijelo zahtjeva prekoračuje ograničenje | Koristite manju datoteku |
415 | Nepodržan format datoteke | Koristite drugi format |
422 | Validacija nije uspjela ili je datoteka prazna ili nema ništa za obradu. | Popravite polja; ne pokušavajte ponovno automatski |
429 | Ograničeno stopom, veličinom reda ili budžetom | Pogledajte dolje |
5xx | Privremena greška usluge | Eksponencijalno odgađanje s maksimalnim brojem pokušaja |
Zaštita od 429
Section titled “Zaštita od 429”code | Značenje | Što učiniti |
|---|---|---|
RATE_LIMITED | Previše zahtjeva | Sčekajte Retry-After, a zatim pokušajte ponovo |
CONCURRENCY_LIMITED | Previše zadataka za prevod putem datoteka je u reduju | Sčekajte Retry-After ili da neki zadaci završe |
AUTH_API_KEY_QUOTA_EXCEEDED | Proračun ključa je potrošen | Ne pokušavajte ponovno dok se budžet ne poveća |
A 429 bez Retry-After treba tretirati pomoću eksponencijalnog odgađanja.
Strategija ponovnog pokušaja
Section titled “Strategija ponovnog pokušaja”- Upiti se mogu ponovno pokrenuti izravno.
- Prilikom ponovnog pokušaja zahtjeva za kreiranje, koristite isti
Idempotency-Keyi potpuno istu tijelo; za svaku novu predaju koristite novi ključ. - Nakon neuspjelog učitavanja, zatražite novu adresu za učitavanje.
- Postavite vrijeme timeouta za povezivanje, čitanje i ukupno vrijeme za svaku zahtjev, dodajte nasumičnu fluktuaciju ponovljenim pokušajima i ograničite broj pokušaja.
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())