Shughulikia makosa ya API na majaribio tena

Kagua kila mara hali ya HTTP kabla ya kusoma jibu kama mafanikio. Huduma za ShareAI zinaweza kurudisha bahasha tofauti za hitilafu: inference inaweza kutoa error.code, OAuth inatoa error na error_description, na njia za Console zinaweza kurudisha code, message na data.status.

Hali	Maana ya kawaida	Urejeshaji
200 na kitu cha hitilafu	Hakuna matokeo ya upatikanaji wa kifaa katika endpoint ya mazungumzo ya sasa.	Kagua error.code na usiiwasilishe kama jibu la msaidizi.
400	Ombi batili au ruzuku ya OAuth.	Sahihisha mwili, vigezo, callback au msimbo uliokwisha muda/uliotumika.
401	Kukosekana, kuisha muda au uthibitisho batili.	Angalia hati; sasisha tu ruhusa halali ya OAuth.
402	Mikopo haitoshi au salio linalotumika.	Angalia salio la akaunti iliyochaguliwa kabla ya kujaribu tena.
403	Upeo, umiliki, jukumu au kukataliwa kwa hali iliyowezeshwa.	Angalia mipaka ya ruhusa iliyoandikwa.
404	Rasilimali isiyojulikana au njia ya lango isiyoungwa mkono.	Angalia mwenyeji, njia na vitambulisho vya rasilimali.
409	Mgongano wa hali au marekebisho.	Soma hali ya sasa na fikiria tena mabadiliko.
429	Ombi au kikomo cha ushirikiano.	Heshimu Retry-After na tumia kurudi nyuma kwa mipaka.
500 / 502 / 503	Kushindwa kwa upatikanaji wa seva au mtiririko wa juu.	Weka majaribio ya kurudia yakiwa na mipaka; hifadhi vitambulisho vya uchunguzi.

Jaribu kusoma tena kwa kikomo#

Kwa kushindwa kwa muda kwenye usomaji, subiri kwa kuchelewesha kwa kuongezeka na jitter, heshimu Retry-After inapopatikana na acha baada ya jaribio lililobainishwa au bajeti ya muda. Onyesha mtumiaji wakati data haipatikani badala ya kurudia kimya kimya.

Shughulikia maandishi kwa uangalifu#

Usirudie kiotomatiki sasisho la bei, uundaji wa modeli au amri ya kushiriki wakati matokeo hayajulikani. Soma hali ya rasilimali au amri kwanza. Tumia Idempotency-Key tu kwenye sehemu za mwisho zinazounga mkono, kama vile mabadiliko ya makubaliano.

Tokeni za upya ni za matumizi moja#

Usasishaji wa mzunguko unahitaji kufuli kwa kila ruhusa katika mfumo wako wa nyuma. Jaribio la kipofu la kusasisha tokeni iliyotumika linaweza kufuta ruhusa. Tazama usasishaji salama wa tokeni.

Nini cha kujumuisha katika ombi la msaada#

Jumuisha sehemu ya mwisho, hali ya HTTP, msimbo wa hitilafu, muda na kitambulisho cha majibu/kazi inapopatikana. Ondoa vichwa vya Authorization, vidakuzi, siri za mteja, tokeni za ufikiaji, tokeni za usasishaji na maudhui ya maelekezo ya kibinafsi.