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.
Starea HTTP
Section titled “Starea HTTP”| Stare | Semnificație | Sfaturi |
|---|---|---|
400 | Cerere invalidă, de exemplu setarea aleasă nu este disponibilă | Corectează cererea; nu reîncerca |
401 | Credențiale lipsă, invalide, expirate sau revocate | Schimbați credențiala |
402 | Soldul (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 |
403 | Limitele 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 |
404 | Resursa nu există, a fost ștearsă sau aparține unui alt cont (toate cele trei situații arată la fel) | Verificați ID-ul |
409 | Cheia de idempotență a fost utilizată pentru o cerere diferită, sau starea resursei nu permite operația. | Interoghează operația originală, apoi decide |
410 | Resursa 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 |
413 | Fișierul sau corpul cererii depășește limita | Utilizați un fișier mai mic |
415 | Format de fișier neunterat | Utilizați un alt format |
422 | Validarea a eșuat, sau fișierul este gol sau nu conține nimic de procesat. | Corectați câmpurile; nu reîncercați automat |
429 | Rata, dimensiunea cozi sau buget limitat | Vedeți mai jos |
5xx | Eroare temporară a serviciului | Exponențial backoff cu un număr maxim de încercări |
Tratament 429
Section titled “Tratament 429”code | Semnificație | Ce să fac |
|---|---|---|
RATE_LIMITED | Prea multe cereri | Așteptați Retry-After, apoi încercați din nou |
CONCURRENCY_LIMITED | Prea 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_EXCEEDED | Bugetul cheii s-a epuizat | Nu reluați încercarea până când bugetul nu este majorat |
Un 429 fără Retry-After ar trebui tratat cu backoff exponențial.
Strategie de retried
Section titled “Strategie de retried”- 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 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())