跳转到内容

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.

StatusZnačenjeSavjeti
400Nevaljana zahtjev, primjerice odabrano postavljanje nije dostupnoPopravite zahtjev; ne pokušavajte ponovno
401Poverenica nedostaje, nije valjana, istekla je ili je opozvanaPromijenite vjerodajnice
402Saldo (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.
403Ogranič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
404Resurs ne postoji, izbrisan je ili pripada drugom računu (sva tri izgledaju isto)Provjerite ID
409Ključ idempotencije korišten je za drugačiji zahtjev ili stanje resursa ne dopušta operaciju.Query originalnu operaciju, a zatim odlučite
410Resurs 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
413Datoteka ili tijelo zahtjeva prekoračuje ograničenjeKoristite manju datoteku
415Nepodržan format datotekeKoristite drugi format
422Validacija nije uspjela ili je datoteka prazna ili nema ništa za obradu.Popravite polja; ne pokušavajte ponovno automatski
429Ograničeno stopom, veličinom reda ili budžetomPogledajte dolje
5xxPrivremena greška uslugeEksponencijalno odgađanje s maksimalnim brojem pokušaja
codeZnačenjeŠto učiniti
RATE_LIMITEDPreviše zahtjevaSčekajte Retry-After, a zatim pokušajte ponovo
CONCURRENCY_LIMITEDPreviše zadataka za prevod putem datoteka je u redujuSčekajte Retry-After ili da neki zadaci završe
AUTH_API_KEY_QUOTA_EXCEEDEDProračun ključa je potrošenNe pokušavajte ponovno dok se budžet ne poveća

A 429 bez Retry-After treba tretirati pomoću eksponencijalnog odgađanja.

  • Upiti se mogu ponovno pokrenuti izravno.
  • Prilikom ponovnog pokušaja zahtjeva za kreiranje, koristite isti Idempotency-Key i 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 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())