Sari la conținut

Erori și retrageri

Erorile de business returnează code și message la nivelul superior al corpului răspunsului. detail este de obicei identic cu message, dar poate fi o explicație diferită, mai scurtă (așa cum se vede mai jos); afișați message utilizatorilor. Mesajele sunt în limba chineză:

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

Unele erori de business returnează doar code. Erorile de validare returnează 422 cu o listă de erori de câmp în detail:

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

Tratează erorile mai întâi prin statusul HTTP, apoi prin code: multe erori returnează doar codul generic UNKNOWN_ERROR, iar doar unele au un cod specific code (cum ar fi cele 429 de cazuri menționate mai jos). Înregistrează header-ul de răspuns X-Request-Id pentru diagnosticare.

StareSemnificațieSfaturi
400Cerere invalidă, de exemplu setarea aleasă nu este disponibilăCorectează cererea; nu reîncerca
401Credențiale lipsă, invalide, expirate sau revocateSchimbați credențiala
402Soldul (după deducerea datoriilor) nu depăşește pragul de job, sau este negativ; cu o cheie API, bugetul rămas al cheii ar putea fi prea scăzut.Actualizați (sau creșteți bugetul cheii), apoi trimiteți din nou
403Limitele cheii nu permit această operare (de exemplu, setarea de traducere nu este permisă), contul este dezactivat sau operația trebuie efectuată într-un browser cu sesiune activă (cum ar fi administrarea cheilor API).Verificați setările cheie sau folosiți site-ul web
404Resursa nu există, a fost ștearsă sau aparține unui alt cont (toate cele trei situații arată la fel)Verificați ID-ul
409Cheia de idempotență a fost utilizată pentru o cerere diferită, sau starea resursei nu permite operația.Interoghează operația originală, apoi decide
410Resursa sau punctul de terminare a dispărut definitiv, de exemplu un punct de terminare închis sau o sarcină ștearsă asociată cu o cheie de idempotență.Nu reîncercați
413Fișierul sau corpul cererii depășește limitaUtilizați un fișier mai mic
415Format de fișier neunteratUtilizați un alt format
422Validarea a eșuat, sau fișierul este gol sau nu conține nimic de procesat.Corectați câmpurile; nu reîncercați automat
429Rata, dimensiunea cozi sau buget limitatVedeți mai jos
5xxEroare temporară a serviciuluiExponențial backoff cu un număr maxim de încercări
codeSemnificațieCe să fac
RATE_LIMITEDPrea multe cereriAșteptați Retry-After, apoi încercați din nou
CONCURRENCY_LIMITEDPrea multe sarcini de traducere a fișierelor sunt în coadăAșteptați Retry-After, sau până când unele sarcini se finalizează
AUTH_API_KEY_QUOTA_EXCEEDEDBugetul cheii s-a epuizatNu reluați încercarea până când bugetul nu este majorat

Un 429 fără Retry-After ar trebui tratat cu backoff exponențial.

  • Consultările pot fi reîncercate direct.
  • Atunci când resursează o cerere de creare, reutilizați același Idempotency-Key și exact același corp; folosiți o cheie nouă pentru fiecare submitere nouă.
  • După o încercare de încărcare nereușită, solicitați o nouă adresă de încărcare.
  • Setați timpii de așteptare pentru conectare, citire și total pentru fiecare cerere, adăugați o întârziere aleatorie la retrageri și limitați numărul de încercări.
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())