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.
HTTP állapot
Szekció neve “HTTP állapot”| Állapot | Jelentés | Taná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 |
401 | Hitelesítő adat hiányzik, érvénytelen, lejárt vagy visszavonásra került | Módosítsa az hitelesítési adatokat |
402 | Az 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. |
403 | Az 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. |
404 | Az 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 |
409 | Az 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 |
410 | Az 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 |
413 | A fájl vagy a kérelem testje meghaladja a korlátot | Használjon kisebb fájlt |
415 | Támogatás nélküli fájlformátum | Használjon más formátumot |
422 | Az é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 |
429 | Sebesség, sor mérete vagy költségvetés korlátozott | Lásd alább |
5xx | Ideiglenes szolgáltatási hiba | Exponenciális visszavárás maximális kísérletszámmal |
429 kezelése
Szekció neve “429 kezelése”code | Jelentés | Mit kell tenni |
|---|---|---|
RATE_LIMITED | Túl sok kérés | Várjon a Retry-After-re, majd próbálja újra |
CONCURRENCY_LIMITED | Túl sok fájlfordítási feladat van sorban | Várjon a Retry-After-re, vagy amíg néhány feladat be nem fejeződik |
AUTH_API_KEY_QUOTA_EXCEEDED | A kulcs költségvetése elfogyott | Ne 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ő.
Újrafeladási stratégia
Szekció neve “Újrafeladási stratégia”- 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 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())