Tovább a tartalomhoz

Hibák és újrapróbálások

Az üzleti hibák a választest felső szintjén code és message értéket adnak vissza. A detail általában megegyezik a message-vel, de lehet egy másik, rövidebb magyarázat is (lásd alább); a felhasználóknak a message értéket jelenítsük meg. Az üzenetek kínai nyelven vannak:

{
"code": "CONCURRENCY_LIMITED",
"message": "排队中的文件已达上限(1000 个),请等部分文件翻译完成后再提交",
"detail": "排队文件完成一部分后可继续提交"
}

Néhány üzleti hiba csak a code értéket adja vissza. Az érvényességi ellenőrzés sikertelensége a 422 kódot eredményezi, a detail mezőben szereplő hibák listájával:

{
"detail": [
{ "loc": ["body", "target_lang"], "msg": "Field required", "type": "missing" }
]
}

Kezelje a hibákat először a HTTP állapot szerint, majd a code szerint: sok hiba csak az általános UNKNOWN_ERROR értéket adja vissza, és csak néhány tartalmaz konkrét code (például az alábbi 429 eset). Jegyezze fel a X-Request-Id válaszfejlécet a hibaelhárítás érdekében.

ÁllapotJelentésTanács
400Érvénytelen kérés, például a választott beállítás nem elérhető.Javítsa ki a kérést; ne próbálkozzon újra
401Hitelesítő adat hiányzik, érvénytelen, lejárt vagy visszavonásra kerültMódosítsa az hitelesítési adatokat
402Az egyensúly (adósság után) nem haladja meg a munka küszöbértékét, vagy negatív; API-kulcs esetén a kulcs maradék költségvetése túl alacsony lehet.Töltsön fel (vagy növelje a kulcs költségvetését), majd küldje be újra.
403Az kulcs korlátai nem teszik lehetővé ezt a műveletet (például a fordítási beállítás nem engedélyezett), a fiók letiltva van, vagy a műveletet bejelentkezett böngészőben kell elvégezni (például az API-kulcsok kezelése).Ellenőrizze a kulcsbeállításokat, vagy használja a weboldalt.
404Az erőforrás nem létezik, törölve lett vagy egy másik fiókhoz tartozik (mindhárom eset ugyanúgy néz ki)Ellenőrizze az azonosítót
409Az idempotencia kulcsát más kéréssel használták, vagy az erőforrás állapota nem teszi lehetővé a műveletet.Kérdezze le az eredeti műveletet, majd döntsön
410Az erőforrás vagy végpont véglegesen eltűnt, például egy megszüntetett végpont vagy egy törölt feladat egy idempotencia kulcs mögött.Ne próbálkozz újra
413A fájl vagy a kérelem testje meghaladja a korlátotHasználjon kisebb fájlt
415Támogatás nélküli fájlformátumHasználjon más formátumot
422Az érvényesítés sikertelen volt, vagy a fájl üres, vagy nincs benne feldolgozandó tartalom.Javítsa ki a mezőket; ne próbálja újra automatikusan
429Sebesség, sor mérete vagy költségvetés korlátozottLásd alább
5xxIdeiglenes szolgáltatási hibaExponenciális visszavárás maximális kísérletszámmal
codeJelentésMit kell tenni
RATE_LIMITEDTúl sok kérésVárjon a Retry-After-re, majd próbálja újra
CONCURRENCY_LIMITEDTúl sok fájlfordítási feladat van sorbanVárjon a Retry-After-re, vagy amíg néhány feladat be nem fejeződik
AUTH_API_KEY_QUOTA_EXCEEDEDA kulcs költségvetése elfogyottNe próbálkozzon újra, amíg a költségvetést nem emelik meg.

A 429 Retry-After nélkül exponenciális visszavonulással kezelendő.

  • A lekérdezéseket közvetlenül újra lehet indítani.
  • Ha újra próbálkozik egy létrehozási kéréssel, használja ugyanazt a Idempotency-Key értéket és pontosan ugyanazt a testet; minden új beküldéshez használjon új kulcsot.
  • Sikertelen feltöltés után kérjen új feltöltési címet.
  • Állítsa be az egyes kérésekhez tartozó kapcsolódási, olvasási és teljes időtúllépési határokat, adjon hozzá véletlenszerű ingadozást a megismételt kísérletekhez, és korlátozza a próbálkozások számát.
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())