Sarrafa kurakuran API da sake gwadawa

Koyaushe bincika matsayin HTTP kafin karanta amsa a matsayin nasara. Ayyukan ShareAI na iya dawo da nau'ikan kurakurai daban-daban: inference na iya bayarwa error.code, OAuth yana bayarwa error kuma error_description, kuma hanyoyin Console na iya dawowa code, message kuma data.status.

Matsayi	Ma'anar gama gari	Gyara
200 tare da abu na kuskure	Sakamakon rashin samuwar na'ura a tashar tattaunawa ta yanzu.	Bincika error.code kuma kar ka nuna shi a matsayin amsar mataimaki.
400	Buƙatar mara inganci ko OAuth grant.	Gyara jikin, sigogi, kiran dawowa ko lambar da ta ƙare/ta cika.
401	Rashin, ƙarewa ko kuma ingantacciyar tantancewa.	Duba takardar shaidar; sabunta kawai ingantacciyar izinin OAuth.
402	Rashin isassun kuɗi ko ma'auni mai dacewa.	Duba ma'aunin asusun da aka zaɓa kafin sake gwadawa.
403	Ƙin yarda da iyaka, mallaka, matsayi ko yanayin kunnawa.	Duba iyakar izini da aka rubuta.
404	Ba a san albarkatun ba ko kuma hanyar shiga ba ta goyan baya.	Duba mai masauki, hanya da alamun albarkatun.
409	Rikici a yanayi ko sake dubawa.	Karanta yanayin yanzu kuma sake tunani akan canjin.
429	Buƙata ko iyakar aiki tare.	Girmama Retry-After kuma yi amfani da jinkiri mai iyaka.
500 / 502 / 503	Gazawar samuwar uwar garke ko tushen sama.	Ci gaba da iyakance sake gwadawa; kiyaye alamun gano matsala.

Sake gwada karantawa tare da iyaka#

Don gazawa na ɗan lokaci akan karatu, jira tare da ƙara jinkiri da jitter, girmama Retry-After idan akwai kuma dakata bayan ƙoƙari ko kasafin lokaci da aka ayyana. Nuna wa mai amfani lokacin da bayanai ba su samu ba maimakon maimaita ba tare da iyaka ba.

Yi hankali da rubuce-rubuce#

Kada a maimaita sabunta farashi ta atomatik, ƙirƙirar samfurin ko umarnin rabawa lokacin da sakamakon bai bayyana ba. Karanta albarkatun ko yanayin umarni da farko. Yi amfani da Idempotency-Key kawai akan hanyoyin da ke da takaddun goyon baya, kamar canje-canjen yarjejeniya.

Tokens na sabuntawa suna amfani sau ɗaya kawai#

Sabunta juyawa yana buƙatar kullewa ta izini a bayan fage. Sake gwadawa ba tare da hankali ba na alamar sabunta da aka yi amfani da ita na iya soke izinin. Duba sabunta alamar lafiya.

Abubuwan da za a haɗa a cikin buƙatar tallafi#

Haɗa hanyar shiga, matsayin HTTP, lambar kuskure, lokaci da alamar amsa/ayyuka idan akwai. Cire Shugabannin Izini, kukis, sirrin abokin ciniki, alamun shiga, alamun sabuntawa da abubuwan sirri na tambaya.