Gestionează erorile API și reîncercările

Inspectează întotdeauna statusul HTTP înainte de a citi un răspuns ca fiind de succes. Serviciile ShareAI pot returna diferite pachete de erori: inferența poate furniza error.code, OAuth furnizează error și error_description, iar rutele Consolă pot returna code, message și data.status.

Stare	Semnificație tipică	Recuperare
200 cu un obiect de eroare	Rezultat de indisponibilitate a dispozitivului în endpoint-ul de chat curent.	Inspectează error.code și nu îl afișa ca răspuns al asistentului.
400	Cerere invalidă sau grant OAuth.	Corectează corpul, parametrii, callback-ul sau codul expirat/consumat.
401	Autentificare lipsă, expirată sau invalidă.	Verifică acreditivul; reînnoiește doar un grant OAuth valid.
402	Credite insuficiente sau sold neaplicabil.	Verifică soldul contului selectat înainte de a încerca din nou.
403	Refuzare pentru domeniu, proprietate, rol sau stare activată.	Verifică limita documentată a permisiunilor.
404	Resursă necunoscută sau rută de gateway nesuportată.	Verifică gazda, calea și identificatorii resursei.
409	Conflict de stare sau revizie.	Citește starea curentă și reconsideră modificarea.
429	Limită de cereri sau concurență.	Respectă Retry-After și folosește un backoff limitat.
500 / 502 / 503	Eșec de disponibilitate al serverului sau upstream.	Păstrează încercările limitate; menține identificatorii de diagnostic.

Reîncearcă citirile cu o limită#

Pentru eșecuri temporare la citiri, așteaptă cu o întârziere și jitter crescătoare, respectă Retry-After când este prezent și oprește-te după un număr definit de încercări sau un buget de timp. Afișează utilizatorului când datele nu sunt disponibile în loc să buclezi în tăcere.

Tratează scrierile cu atenție#

Nu repeta automat o actualizare de preț, o creare de model sau o comandă de partajare când rezultatul este necunoscut. Citește mai întâi starea resursei sau a comenzii. Folosește un Idempotency-Key doar pe endpoint-uri care documentează suportul, cum ar fi modificările de acorduri.

Token-urile de reîmprospătare sunt de unică folosință#

Reîmprospătarea rotației necesită un blocaj per-autorizare în backend-ul tău. O încercare oarbă de reîmprospătare a unui token consumat poate revoca acordul. Vezi reîmprospătare sigură a token-ului.

Ce să incluzi într-o cerere de suport#

Include endpoint-ul, statusul HTTP, codul de eroare, ora și identificatorul răspunsului/sarcinii când sunt disponibile. Elimină anteturile Authorization, cookie-urile, secretele clientului, token-urile de acces, token-urile de reîmprospătare și conținuturile private ale prompturilor.