Greške i ponovljeni pokušaji
Poslovne greške vraćaju code i message na najvišem nivou tela odgovora. detail je obično isto kao message, ali može biti drugačije, kraće objašnjenje (kao u nastavku); korisnicima prikažite message. Poruke su na kineskom:
{ "code": "CONCURRENCY_LIMITED", "message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交", "detail": "排队文件完成一部分后可继续提交"}Nekoliko poslovnih grešaka vraća samo code. Neuspesi validacije vraćaju 422 sa listom grešaka polja u detail:
{ "detail": [ { "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" } ]}Obradite greške prvo postavkom HTTP, a zatim postavkom code: mnoge greške vraćaju samo opšti kod UNKNOWN_ERROR, a samo neke sadrže specifični kod code (kao što su 429 slučajeva u nastavku). Zabeležite zaglavlje odgovora X-Request-Id radi rešavanja problema.
HTTP status
Section titled “HTTP status”| Status | Značenje | Saveti |
|---|---|---|
400 | Nevažeći zahtev, na primer odabrana postavka nije dostupna | Ispravite zahtev; nemojte ponovo pokušavati |
401 | Kredencijal nedostaje, nevalidan, istekao ili opozvan | Promenite akreditiv |
402 | Saldo (nakon duga) nije iznad praga za posao, ili je negativno; uz API ključ, preostali budžet ključa može biti premalen. | Dopunite (ili povećajte budžet za ključ), a zatim ponovo pošaljite |
403 | Ograničenja ključa ne dozvoljavaju ovu operaciju (na primer, podešavanje prevoda nije dozvoljeno), nalog je onemogućen ili operacija mora da se izvrši u prijavljenom pregledaču (kao što je upravljanje API ključevima) | Proverite ključne postavke ili koristite veb-sajt |
404 | Resurs ne postoji, izbrisan je ili pripada drugom nalogu (sve tri opcije izgledaju isto) | Proverite ID |
409 | Ključ idempotentnosti je korišćen za drugačiji zahtev, ili stanje resursa ne dozvoljava operaciju | Zapitajte se o prvobitnoj operaciji, a zatim odlučite |
410 | Resurs ili krajnja tačka je trajno nestao, na primer, povučena krajnja tačka ili obrisana veza iza ključa idempotentnosti. | Ne pokušavajte ponovo |
413 | Datoteka ili telo zahteva prevazilazi ograničenje | Koristite manju datoteku |
415 | Nepodržan format datoteke | Koristite drugi format |
422 | Validacija nije uspela, ili je datoteka prazna ili nema ništa za obradu | Ispravite polja; nemojte automatski ponavljati pokušaj |
429 | Stopa, veličina reda ili budžet su ograničeni | Pogledajte ispod |
5xx | Privremena greška servisa | Eksponencijalno odlaganje sa maksimalnim brojem pokušaja |
Rešavanje 429
Section titled “Rešavanje 429”code | Značenje | Šta uraditi |
|---|---|---|
RATE_LIMITED | Previše zahteva | Sačekajte Retry-After, a onda ponovite pokušaj |
CONCURRENCY_LIMITED | Previše zadataka za prevod datoteka je u redu | Sačekajte Retry-After, ili da se završe neki zadaci |
AUTH_API_KEY_QUOTA_EXCEEDED | Budžet ključa je iscrpljen | Ne pokušavajte ponovo dok se budžet ne poveća |
A 429 bez Retry-After treba da se tretira pomoću eksponencijalnog odgađanja.
Strategija ponovnog pokušaja
Section titled “Strategija ponovnog pokušaja”- Zapiti se mogu ponovo pokrenuti direktno.
- Prilikom ponovnog pokušaja zahteva za kreiranje, koristite istu vrednost
Idempotency-Keyi potpuno isti telo; za svaku novu submisiju koristite novi ključ. - Nakon neuspešnog otpremanja, zatražite novu adresu za otpremanje.
- Postavite vremenska ograničenja za povezivanje, čitanje i ukupno vreme za svaku zahtevu, dodajte slučajni džiter na ponovne pokušaje 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())