Ịhazi ọkwa “na-aga n'ihu” mgbe a na-enyocha usoro site na API

Gịnị ka processing pụtara na nzaghachi API

Ọkwa processing, in_progress ma ọ bụ ọnọdụ ọzọ hà nhata pụtara na onye na-eweta ọrụ anabatala usoro ka ọ rụọ ọrụ, mana o kwupụtaghị nsonaazụ ikpeazụ. Maka ọrụ nkwalite, nke a nwere ike ịbụ nyocha nke njikọ, ichere n'ahịrị, ịmalite ọrụ ma ọ bụ iwepụta oke a rịọrọ nwayọọ nwayọọ.

Processing anaghị akwado mmezu nke ọma ma ọ pụtaghị njehie. Mgbe ya gasịrị, usoro nwere ike ịgafe na completed, partial, canceled ma ọ bụ failed. Ka onye na-eweta ọrụ na-eweghachi ọkwa etiti, e mepụla arịrịọ ọzọ maka otu njikọ ahụ na otu oke ahụ.

HTTP 200 na ọkwa processing pụtara nzaghachi API gara nke ọma, ọ bụghị mmezu nke usoro gara nke ọma. Ekwesịrị ichekwa ma hazie ihe omume ndị a iche.

Kedu data dị mkpa maka nyocha usoro

Maka polling, ị chọrọ ID mpụga nke usoro nke onye na-eweta ọrụ weghachiri mgbe e mepụtara ya. Chekwaa ya tinyere ID ime, oke mbụ, paramita ọrụ, njikọ, oge e mepụtara na nzaghachi API mbụ. Ịchọ usoro site n'aha ọwa, njikọ ma ọ bụ oke abụghị ihe a pụrụ ịdabere na ya: ụkpụrụ ndị dị otú ahụ nwere ike ịdaba n'ọtụtụ arịrịọ.

Ọ bụrụ na oge nkwụsị bịara mgbe e mepụtara ya, ezisela arịrịọ ọzọ na-akpaghị aka. Onye na-eweta ọrụ nwere ike ịnara arịrịọ ahụ, mana nzaghachi nwere ike ịla n'iyi n'ụzọ. Buru ụzọ jiri usoro ịchọ usoro ma ọ bụrụ na ọ dị na akwụkwọ, ma ọ bụ nyefee okwu ahụ maka nyocha.

Mba nke ichekwa naanị ọkwa dị ugbu a bụ na n'esemokwu, ọ gaghị ekwe omume iweghachi mgbe usoro gafere na processing, ma enwere ọganihu, na kedu nzaghachi bịara na mbụ.

Ọmụmaatụ arịrịọ ọkwa site na curl

Were adreesị ziri ezi, usoro nyocha na aha ubi site na akwụkwọ onye na-eweta ọrụ. N'okpuru e gosiri ndebiri: a ga-eji data nke API akọwapụtara dochie ụkpụrụ ndị dị n'ime akara nkuku.

Arịrịọ GET maka otu usoro

curl -X GET "https:///orders//status" \

-H "Authorization: Bearer " \

-H "Accept: application/json"

Ọmụmaatụ nzaghachi:

{

"order_id": "",

"status": "processing",

"completed_quantity": 250,

"remains": 750,

"updated_at": "значение_времени"

}

Ubi completed_quantity na remains bụ naanị ọmụmaatụ nke nhazi. Onye na-eweta ọrụ nwere ike iji progress, start_count, balance ma ọ bụ aha ndị ọzọ. Mba nke usoro GET bụ na ụfọdụ API na-anabata nyocha ọkwa naanị site na POST.

Ọmụmaatụ arịrịọ POST na nyocha otu ìgwè

Arịrịọ POST maka ọkwa otu usoro

curl -X POST "https:///orders/status" \

-H "Authorization: Bearer " \

-H "Content-Type: application/json" \

-d '{"order_id":""}'

Efefela igodo API n'ahịrị URL. Adreesị arịrịọ na-abanye na ndekọ proxy, sistemụ nyocha, akụkọ ihe nchọgharị na ndekọ teknụzụ. Mba nke POST bụ na ọ siri ike iji aka nyochaa ya site n'ahịrị adreesị, mana nke ahụ abụghị ihe kpatara ibugharị ihe nzuzo na URL.

Arịrịọ otu ìgwè maka usoro ndị na-arụ ọrụ

Ọ bụrụ na API na-akwado nyocha otu ìgwè, ziga ọtụtụ ID n'otu arịrịọ:

curl -X POST "https:///orders/statuses" \

-H "Authorization: Bearer " \

-H "Content-Type: application/json" \

-d '{"order_ids":["",""]}'

Jikọta nzaghachi na usoro ime site na ID mpụga, ọ bụghị site n'ọnọdụ ihe dị n'usoro. Mba nke nyocha otu ìgwè: onye na-eweta ọrụ nwere ike weghachi ọ bụghị usoro niile, gbochie oke ndepụta ma ọ bụ kọọ njehie naanị maka otu ID.

Otu esi ahọpụta polling maka processing

Mgbe nzaghachi processing mbụ gasịrị, tinye nyocha ọzọ n'ahịrị. Họrọ oge n'etiti site na akwụkwọ API, oke ugboro na ụdị ọrụ. Maka ọrụ ebe ọkwa na-agbanwe ngwa ngwa, nyocha ugboro ugboro na mmalite kwere omume. Maka nkwalite nwayọọ nwayọọ, arịrịọ dị mkpirikpi mgbe niile anaghị enye ozi ọhụrụ.

Usoro bara uru bụ ịbawanye nkwụsị mgbe nzaghachi processing yiri nke ahụ gasịrị. Nyocha mbụ na-aga mgbe oge ichere mmalite gasịrị, mgbe ahụ oge n'etiti na-eto ruo oke kachasị elu edobere. Ọ bụrụ na API weghachiri ọganihu ma ọ bụ oge mmelite ọhụrụ, enwere ike ịmalite ngụkọ site na mgbanwe ahụ.

• Mgbe e mepụtara usoro, enyochala ọkwa ozugbo ọtụtụ ugboro n'usoro: ọrụ nwere ike ịchọ oge iji tinye ya n'ahịrị.
• Mgbe processing na-emegharị, bawanye oge n'etiti arịrịọ, ọ bụghị idobe ugboro mgbe niile.
• Tinye obere mgbanwe na-enweghị usoro na oge mmalite ọrụ ka usoro ghara ịjụ API n'otu oge.
• Ọ bụrụ na onye na-eweta ọrụ na-enyefe Retry-After ma ọ bụ ndụmọdụ yiri ya, jiri ya dị ka ihe kacha mkpa.
• Maka usoro nwere webhooks, hapụ polling nchịkwa: ọkwa nwere ike ịghara iru.

Mba nke polling na-adịghị adịkarị — interface nwere ike igosi ọkwa ochie mgbe mmezu gasịrị. Mba nke polling ugboro ugboro — ihe ize ndụ nke ịdaba na oke API, ịnata 429 na ịmepụta ibu ọzọ.

Kedu oge ekwesịrị ichekwa maka njikwa processing

Iji mata ọdịiche dị n'etiti mmezu nkịtị na nkwụsị, otu ọkwa dị ugbu a ezughị. Maka usoro ọ bụla na-arụ ọrụ, chekwaa oge e mepụtara, nnata processing mbụ, nzaghachi API gara nke ọma ikpeazụ, mgbanwe ọkwa mpụga ikpeazụ na mgbanwe ọganihu ikpeazụ.

Ọ dịkwa mma ichekwa oke mbụ, oke emezuru akwadoro, fọdụrụ na ọkwa mbụ nke onye na-eweta ọrụ. Ọ bụrụ na API anaghị enye ọganihu, nke ahụ abụghị ihe kpatara iwere usoro dị ka nke kwụsịrị: dabere na oge nzaghachi ikpeazụ na oge nhazi a tụrụ anya ya, ọ bụrụ na e gosiri ya na ọnọdụ ọrụ.

Enweghị ike ịtọ oge ichere kachasị elu dị ka otu ọnụọgụ maka ọrụ niile. Jiri oge onye na-eweta ọrụ gosiri maka ọrụ akọwapụtara, yana obere ohere ime maka ahịrị na mmelite data. Ọ bụrụ na e gosighi oge, tọọ iwu dị iche maka ụdị ọrụ ọ bụla ma nyochaa ya site na akụkọ ihe mere eme nke nhazi n'ezie.

Gịnị ka a ga-eme ma ọ bụrụ na processing anaghị agbanwe

Processing ogologo oge anaghị egosi njehie. Buru ụzọ lelee ma nzaghachi API gara nke ọma ọ bịara, ma completed_quantity ma ọ bụ remains gbanwere, ma enwere webhooks, na ma iwu ọrụ agbanweela. Enweghị ọganihu a na-ahụ anya nwere ike ịbụ n'ihi igbu oge nke ọnụ ọgụgụ nke ikpo okwu ma ọ bụ na onye na-eweta ọrụ na-emelite ọganihu naanị na njedebe.

Mgbe oge ichere ime gafere, akagbuola usoro na-akpaghị aka. Mee nyocha ọkwa pụrụ iche, rịọ data site na usoro dị iche ma ọ bụrụ na enyere ya, ma lelee akụkọ ọkwa. Ọ bụrụ na onye na-eweta ọrụ ka na-akwado processing, bugharịa usoro na ọnọdụ ime “achọrọ nyocha”, mana chekwaa ọkwa mpụga na-enweghị dochie ya.

• Dekọọ oge nzaghachi akwadoro ikpeazụ na nzaghachi API niile.
• Lelee ma ọganihu agbanweela site na nyocha gara aga.
• Belata ugboro arịrịọ akpaghị aka mgbe iru oke ime gasịrị.
• Nyefee na nkwado ID mpụga, njikọ, paramita ọrụ, akụkọ ọkwa na njehie teknụzụ.
• Emalitegharịla fọdụrụ ruo mgbe nzaghachi onye na-eweta ọrụ ma ọ bụ ọkwa ikpeazụ doro anya.

Mba nke nyocha aka — usoro chọrọ nlebara anya nkwado. Mana ịkagbu akpaghị aka ma ọ bụ mmekọ dị ize ndụ karịa: mmezu nwere ike ịga n'ihu n'aka onye na-eweta ọrụ.

Otu esi ewezuga ọdịda arịrịọ na ọkwa usoro

Njehie netwọk, oge nkwụsị, HTTP 429 na nzaghachi 5xx anaghị ekwu ọnọdụ nke usoro ahụ n'onwe ya. Ha pụtara naanị na enweghị ike ịnata ọkwa ọhụrụ a pụrụ ịdabere na ya. N'ọnọdụ dị otú ahụ, hapụ ọkwa akwadoro ikpeazụ, dekọọ njehie teknụzụ ma hazie nyocha ọhụrụ.

Na 429, tụlee Retry-After ma ọ bụrụ na enyere isi okwu ahụ. Na njehie netwọk nwa oge na 5xx, bawanye nkwụsị n'etiti mgbalị. Na njehie nyocha, mbinye aka ma ọ bụ ikike nnweta, etinyela retries ugboro ugboro: ọ dị mkpa ịlele igodo, oge njedebe token, oke IP na ntọala nnweta.

Ọ bụrụ na API weghachiri HTTP 200, mana a naghị enyocha JSON ma ọ bụ na order_id na status adịghị na nzaghachi, chekwaa ahụ nzaghachi dum ma kaa nyocha ahụ dị ka nke ezighi ezi. Ejighi enweghị ọkwa dochie completed, canceled ma ọ bụ processing.

Mgbe a ga-akwụsị arịrịọ akpaghị aka ọzọ

Polling ekwesịghị ịbụ nke na-adịghị agwụ agwụ. Kpọchie ọnụ ọgụgụ mgbalị teknụzụ maka njehie nwa oge ma jikwaa oge niile usoro nọ na processing iche. Mgbe oke retries gwụchara, bugharịa ọrụ nyocha na ahịrị nyocha, ọ bụghị ịmepụta arịrịọ ọhụrụ kwa nkeji na-enweghị nsonaazụ.

Mgbalị ọzọ arịrịọ ọkwa na-adịkarị mma ma ọ bụrụ na usoro ahụ na-agụ naanị data. Usoro imepụta, ịkagbu, ịgbakwunye, ịmalitegharị na nlọghachi enweghị ike ịmegharị ya na igwe mgbe oge nkwụsị gasịrị. Na-enweghị igodo idempotent ma ọ bụ nkwenye doro anya nke onye na-eweta ọrụ, mgbalị ọzọ dị otú ahụ nwere ike ịgbanwe usoro ugboro abụọ.

Mba nke ịkpọchie retries bụ na ụfọdụ mmelite ga-aghọ ọrụ aka. Retries na-adịghị agwụ agwụ ka njọ: ha na-ekpuchi ọdịda, na-eri oke ma na-eme ka nyocha ndekọ sie ike.

Otu esi anabata ọkwa ikpeazụ mgbe processing gasịrị

Ekweghị ka mgbanwe azụ site na completed gaa na processing n'ihi nzaghachi polling nke oge gara aga ma ọ bụ webhook ochie. Na mmelite ọ bụla, tụnyere oge ihe omume site n'aka onye na-eweta ọrụ, nọmba ụdị usoro ma ọ bụrụ na ọ dị, na ọnọdụ ime dị ugbu a.

• new na pending nwere ike ịgafe na processing, canceled ma ọ bụ failed.
• processing nwere ike ịgafe na completed, partial, canceled ma ọ bụ failed.
• Ekwesịghị iwere partial na-akpaghị aka dị ka completed.
• A na-ewerekarị completed, canceled na failed dị ka ndị ikpeazụ ma na-egbochi nlọghachi akpaghị aka azụ.
• Ọkwa a na-amaghị ama ma ọ bụ mgbanwe na-ekwesịghị ekwesị chọrọ nyocha iche.

Tebụl mgbanwe siri ike nwekwara mba: onye na-eweta ọrụ nwere ike ịgbakwunye ọnọdụ ọhụrụ ziri ezi. Ya mere, chekwaa ọkwa mbụ ma ehichiela ya na nhazi ime.

Otu esi ahazi partial na fọdụrụ usoro

Partial pụtara na akwadoro naanị akụkụ nke oke mbụ. Na nzaghachi API nwere ike ịdị ọnụọgụ emezuru n'ezie, fọdụrụ, ihe kpatara na data gbasara nkwụghachi. Chekwaa ụkpụrụ ndị a iche: enweghị ike iji ọnụọgụ emezuru dochie oke mbụ nke usoro.

Ọmụmaatụ nzaghachi ikpeazụ nwere ike ịdị otú a:

{

"order_id": "",

"status": "partial",

"completed_quantity": 700,

"remains": 300,

"refund": "значение_или_отсутствие_поля"

}

Buru ụzọ chọpụta ihe API na-akwado n'ezie: e meela nlọghachi, a na-eme atụmatụ nlọghachi naanị, e kagbuola fọdụrụ ma ọ bụ achọrọ ịkpọtụrụ nkwado. Ọ bụrụ na enweghị ubi gbasara nlọghachi, echela na a kwụrụ fọdụrụ ụgwọ na-akpaghị aka.

Emalitegharịla akụkụ a na-emezughị na-enweghị mkpebi iche. Onye na-eweta ọrụ nwere ike ka na-emecha ngụkọ, ọnụ ọgụgụ ikpo okwu nwere ike imelite na igbu oge, na arịrịọ ọzọ nwere ike ịmepụta nkwalite mmekọ. Mba nke ichere nkwenye — a gaghị emechi fọdụrụ ozugbo, mana usoro ọzọ agaghị apụta.

Webhooks anaghị edochi nyocha nchịkwa

Webhook na-enye ohere imelite kaadị usoro ozugbo mgbe ihe omume gasịrị, na-echeghị polling ọzọ. N'ime onye nhazi, chọta usoro site na ID mpụga, lelee mbinye aka ma ọ bụ ihe nzuzo, chekwaa ID ihe omume ma tinye mgbanwe naanị mgbe nyochachara na ọ kwere omume.

Nnyefe webhook ugboro ugboro kwesịrị ịdị nchebe: enweghị ike iwere otu ihe omume dị ka mgbanwe ọhụrụ. Ihe omume nwekwara ike ịbịa n'usoro na-ezighi ezi, ya mere ebugala usoro ikpeazụ azụ naanị dabere na processing nke oge gara aga.

A chọrọ polling nchịkwa ọbụna na webhooks kwụrụ ọtọ. Mba nke webhooks — nhazi siri ike karị: achọrọ onye nhazi dịnụ, nchebe pụọ na arịrịọ adịgboroja, mwepu mmekọ na ndekọ ihe omume.

Gịnị ka a ga-egosi onye ahịa na processing na nkwụsị

Na interface, ekwesịghị igosi JSON teknụzụ niile. Maka processing, ọnọdụ “usoro na-arụ ọrụ” ezuru. Ọ bụrụ na API nyefere ọganihu a pụrụ ịdabere na ya, gosi oke akwadoro iche na nke mbụ ma egosila ya dị ka nsonaazụ ikpeazụ.

Maka usoro gafere oge njikwa ime, jiri ọnọdụ doro anya dị ka “anyị na-enyocha mmezu”. Akọwala maka ịkagbu, nlọghachi ma ọ bụ mmezu zuru oke ruo mgbe nzaghachi onye na-eweta ọrụ kwadoro ya.

Ọkwa bara uru mgbe a nabatara usoro, na mmezu ikpeazụ, partial, ịkagbu, njehie na mkpa nyocha. Ozi mgbe polling ọ bụla gasịrị na-eme mkpọtụ ma anaghị enyere onye ahịa aka ịghọta ọnọdụ n'ezie nke arịrịọ.

Kedu ndekọ dị mkpa na ndekọ nhazi

Akụkọ nzaghachi na-enyere aka nyocha processing kwụsịrị, webhook furu efu, esemokwu gbasara mmezu akụkụ na ọdịiche dị n'etiti interface na API. Maka oku ọ bụla, chekwaa ID mpụga, isi iyi mmelite, oge arịrịọ na nzaghachi, koodu HTTP, ọkwa mbụ, ọkwa ahaziri, ọganihu, fọdụrụ na ederede njehie teknụzụ.

Edekọla igodo API, token, mbinye aka na ihe nzuzo ndị ọzọ na ndekọ nkịtị. Kpọchie nnweta na nzaghachi ndị mbụ: ha nwere ike ịnwe data na-ekwesịghị ịdị na interface nkwado.

Tupu mmalite, lelee ọnọdụ nwere processing na-emegharị, enweghị ọganihu, oge nkwụsị, 429, njehie 5xx, JSON ezighi ezi, webhook nke oge gara aga, webhook mmekọ, partial, canceled na ọkwa a na-amaghị ama. Ọnọdụ ule bara uru maka nhazi njikọ, mana mba ya bụ na ọ nwere ike ọ gaghị emegharị ahịrị n'ezie na igbu oge nke API ọrụ.