跳转到内容

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.

StatusZnačenjeSaveti
400Nevažeći zahtev, na primer odabrana postavka nije dostupnaIspravite zahtev; nemojte ponovo pokušavati
401Kredencijal nedostaje, nevalidan, istekao ili opozvanPromenite akreditiv
402Saldo (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
403Ogranič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
404Resurs ne postoji, izbrisan je ili pripada drugom nalogu (sve tri opcije izgledaju isto)Proverite ID
409Ključ idempotentnosti je korišćen za drugačiji zahtev, ili stanje resursa ne dozvoljava operacijuZapitajte se o prvobitnoj operaciji, a zatim odlučite
410Resurs 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
413Datoteka ili telo zahteva prevazilazi ograničenjeKoristite manju datoteku
415Nepodržan format datotekeKoristite drugi format
422Validacija nije uspela, ili je datoteka prazna ili nema ništa za obraduIspravite polja; nemojte automatski ponavljati pokušaj
429Stopa, veličina reda ili budžet su ograničeniPogledajte ispod
5xxPrivremena greška servisaEksponencijalno odlaganje sa maksimalnim brojem pokušaja
codeZnačenjeŠta uraditi
RATE_LIMITEDPreviše zahtevaSačekajte Retry-After, a onda ponovite pokušaj
CONCURRENCY_LIMITEDPreviše zadataka za prevod datoteka je u reduSačekajte Retry-After, ili da se završe neki zadaci
AUTH_API_KEY_QUOTA_EXCEEDEDBudžet ključa je iscrpljenNe pokušavajte ponovo dok se budžet ne poveća

A 429 bez Retry-After treba da se tretira pomoću eksponencijalnog odgađanja.

  • Zapiti se mogu ponovo pokrenuti direktno.
  • Prilikom ponovnog pokušaja zahteva za kreiranje, koristite istu vrednost Idempotency-Key i 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 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())