Ìṣọ̀kan ohunkóhun

HTTP wọ́, HTTP jáde, àwọn apá tí ó lèwu tí a ti tọ́jú

Gbogbo ohun-èlò ìfipamọ́-iṣẹ́ ń kéde nọ́mbà àwọn ìṣọ̀kan. Nọ́mbà náà ńlá nígbà gbogbo, ó sì jẹ́ ìbéèrè àṣìṣe nígbà gbogbo, nítorí pé ètò tí o ní ìfẹ́ kí o lo ni èyí tí wọ́n kọ́ nílé ní ọdún 2014 nípasẹ̀ ẹnikẹ́ni tí ó ti lọ. Ohun tí ó ṣe pàtàkì ni bí ohun-èlò náà ṣe ń sọ èdè ìṣọ̀kan tí ó léyí gbogbo wọn.

Àwọn ìṣọ̀kan tí a ti pèsè tẹ́lẹ̀

Àwọn ohun-èlò tí ọ̀pọ̀ ilé-iṣẹ́ ń lo ti pèsè ìgbésẹ̀: àwọn ilé-ìtajà àti ọjà, ìṣirò owó àti ìfọwọ́sí owó, àwọn ìwé-ìṣirò àti ìpamọ́-dátà, kálẹ́ndà àti ìmẹ́lì, ìpamọ́ àti ìfiránṣẹ́, CRM àti helpdesk, àwọn olùpèsè ìsanwó àti àwọn olùfiránṣẹ́. O fọwọ́sí àkántì náà lẹ́ẹ̀kan kan, àwọn aàyà náà sì ní orúkọ ní èdè tí ohun-èlò náà ń lo, kì í ṣe ní èdè JSON rẹ̀.

Nígbà tí ohun-èlò kan bá ní ìṣe pàtàkì ọjà Polandi — ètò ìfọwọ́sí owó tí ó ní láti ṣetán fún KSeF, olùfiránṣẹ́ tí àwọn àmì rẹ jẹ́ àṣà orílẹ̀-èdè — ìgbésẹ̀ tí a pèsè tẹ́lẹ̀ mọ̀ ọ́, nítorí pé ẹbí náà ń tà sí ọjà yẹn ó sì ní láti kọ́ ọ́.

Lẹ́yìn náà, ọ̀rọ̀ àpẹẹrẹ àgbà

Ohunkóhun tí ó kù jẹ́ ìgbésẹ̀ HTTP, ìgbésẹ̀ HTTP níbí kì í ṣe ẹ̀bùn ìdáríjì. Ó jẹ́ ẹ̀rọ kan náà tí àwọn ìṣọ̀kan tí a pèsè tẹ́lẹ̀ dá lórí, pẹ̀lú ìtọ́jú kan náà fún àwọn apá tí ó ṣòro láti kọ ara rẹ.

Àwọn apá tí ó ṣòro

A ti tọ́jú wọ́n, kí o má tún kọ wọ́n

Ìmúdájú

Bọtìnnì API, àmì bearer, ìfọwọ́sí basic, OAuth 2 pẹ̀lú ìtúnṣe refresh, fínnìfínnì ìbẹ̀rẹ̀ ìbéèrè HMAC, mutual TLS. Wọ́n ń fi ìwọ̀n ìfọwọ́sí kan pamọ́ léègbèé kan, wọ́n sì ń tọ́kasí rẹ̀ ní orúkọ, wọn kò sì fi mọ́ ẹ̀ kọ́kọ́ sí ìwé ìtàn ìṣe tàbí ìwé ìṣe kankan.

Pípín sí ojúewé

Àwọn cursor, nọ́mbà ojú-iwé, àwọn offset, àwọn orí Link, àti API tí ó ń fihàn òpin nípa fífi àkójọpọ̀ tìí ṣọ́. Sọ irú èyí tí ó jẹ́, ìgbésẹ̀ náà yóò rìn kíkọjá gbogbo àkójọpọ̀ náà.

Àwọn àpẹẹrẹ ìdínkù

Àlà kan fún ìbánisọrọ̀ kọ̀ọ̀kan, tí wọ́n ń bọ̀wọ̀ fún ní àwọn iṣẹ́-àkánṣe gbogbo tí ó ń lo ọ́n. Nígbà tí olùpèsè bá dáhùn pẹ̀lú 429 àti Retry-After, ìgbésẹ̀ náà yóò dẹ́kùn fún akókò yẹn kí ó má ba tún ń fọwọ́ kàn án lẹ́ẹ̀kọ̀ọ̀kan.

Ìtún-gbésẹ̀ àti ìfẹ̀yìntì

Àwọn àìṣe déédé tí wọ́n ń tún gbésẹ̀ rẹ̀ pẹ̀lú àfojúfọ̀n tí ń pọ̀ sí i àti àlà. Ìgbésẹ̀ kan jẹ́ iṣẹ́ tí ó mọ́ ara rẹ̀ sí àwọn ìbáwọ̀nyí rẹ̀, nítorí náà ìtún-gbésẹ̀ kan ń tún ṣiṣẹ́ ìgbésẹ̀ náà, kì í ṣe tún ṣiṣẹ́ ìṣe náà gbogbo.

Àwọn ọ̀nà ìfiwéra tí ó ṣòro

JSON, fífi fọ́ọ̀m kọ́, XML, ọ̀rọ̀ kékeré, àwọn gígé multipart. Àwọn ìdáhùn tí wọ́n ti pin sí àwọn pápá tí o lè tọ́kasí ní orúkọ, pẹ̀lú àwọn tí ó wà ní ìpele mẹ́rin sí isàlẹ̀.

Àwọn àkókò òpin

Àlà kan fún ìgbésẹ̀ kọ̀ọ̀kan, kí ìbáwọ̀nyí kan tí ó dàgbà má ba ní olùṣiṣẹ́ kan dúró nígbà tí gbogbo nǹkan tí ń bọ̀ lẹ́yìn rẹ̀ ń dúró ní ìlà ojú. Ohun tí ó ń ṣẹlẹ̀ nígbà tí wọ́n bá kàn àlà náà ni ìpinnu rẹ, fún ìgbésẹ̀ kọ̀ọ̀kan.

Tí ó bá ń sọ èdè HTTP, ìjíròrò náà ti bẹ̀rẹ̀ tẹ́lẹ̀.

Àwọn webhook tí ń wọ́, tí wọ́n fi ọwọ́ sí pátápátá

Iṣẹ́-àkánṣe kọ̀ọ̀kan lè ní URL tí ó ń bẹ̀rẹ̀ iṣẹ́ rẹ̀. URL yẹn ń ṣe ìdájọ àwọn àmì-ìfọwọ́sí — HMAC ní àwọn ọ̀nà tí àwọn olùpèsè pàtàkì ń lò, àti àṣírí tí wọ́n pin pọ̀ ní ibi tí èyí ni ohun tí olùfiránṣẹ́ lè ṣe. Ìbéèrè tí kò ní àmì-ìfọwọ́sí sí iṣẹ́-àkánṣe tí ń retí àmì-ìfọwọ́sí ni wọ́n ń kọ̀ àti fi sí ìwé ìtàn, kì í ṣe fífi ṣiṣẹ́ rẹ̀ ní ìrọ̀rùn.

Ìyọkúrò àwọn ẹ̀dá-mẹ́ta ń ṣẹlẹ̀ lórí ìdánimọ̀ ọ̀nà ìfiwéra fúnra rẹ̀, nítorí náà olùfiránṣẹ́ tí ó tún fi ránṣẹ́ nítorí kò rí 200 rẹ̀ ní àkókò yóò gba ìṣe kan dìde mẹ́ta. Àwọn ọ̀nà ìfiwéra tí ó bá jẹ́ kíkọ àìtọ́ ni wọ́n ń fi pamọ́, pẹ̀lú ìdí tí wọ́n fi kọ̀ wọ́n, nítorí ìdí tí ó pọ̀ jùlọ fún àfojúfọ̀n tí kò ní ìdí nínú ìfágbékalẹ̀ iṣẹ́ ni olùfiránṣẹ́ tí ó yípadà lọ́kàn rere nípa pápá kan.

Àwọn ọ̀nà-ẹ̀rọ tí kò ń sọ èdè mìíràn àyáfá CSV

Wọ́n wà. Fáìlì kan ń farahàn lórí SFTP server ní àago mẹ́rin òsàn, tàbí ó ń dé bí àmì-ìfiwéra, tàbí wọ́n fi sí pápá tí wọ́n pin pọ̀. Iṣẹ́-àkánṣe lè dẹkùn fún un, kà á, kí ó sì fi ọ̀kọ̀ọ̀kan ìlà rẹ̀ sí iṣẹ́-àkánṣe — pẹ̀lú fáìlì tí ó ní byte-order mark, àwọn aṣàyàn semicolon, àti orí ìlà ní èdè Polandi, nítorí èyí ni ọ̀nà tí ìtàjánsí náà fi ń hàn.

Lílọ sí ọ̀nà kejì ń ṣiṣẹ́ pẹ̀lú: iṣẹ́-àkánṣe lè parí fáìlì kan kí ó sì fi sí ibi tí ọ̀nà-ẹ̀rò kejì ń retí rí i, èyí tí ó ń jẹ́ ọ̀nà ìbánisọrọ̀ kanṣoṣo tí ọ̀nà-ẹ̀rọ ọdún 2006 ní.

Ìfúnra olùpèsè ti òruSFTP → HTTP

⚡Ohun-ìmúṣiṣẹ́04:02Fáìlì tuntun lórí SFTP olùpèsè: stock-2026-09-09.csv.
2Ìtúmọ̀Àwọn semicolon, byte-order mark, àwọn orí ìlà Polandi. Àwọn ìlà 4 118.
3Ìdọ́gbàÀwọn kóòdù owó tí wọ́n ti ṣàyẹ̀wò sí ìwọ̀n ìtọ́kasí; wọ́n kọ̀ méjì bíi àìtọ́.
4Tì2.9 sHTTP PATCH ní àwọn ẹgbẹ́ ti 200, ìbọ̀wọ̀ fún àpẹẹrẹ ìdínkù.
!Àwọn àyọkùWọ́n fi ìlà méjì sílẹ̀ fún ẹni kan, pẹ̀lú nọ́mbà ìlà àti ìdí. Àwọn ìlà 4 116 tí ó kù lọ kọjá.

Àwọn ìgbésẹ̀ tí ó pè oríṣiríṣi awoṣe: 0Iye owó ìṣe yìí: kò sí nǹkan

Ibi tí àwọn ìwọ̀n ìfọwọ́sí ń gbé

Wọ́n ti fi ọ̀rọ̀-àṣírí pamọ́, wọ́n ń tọ́kasí wọ́n ní orúkọ, wọ́n sì ń wà fún ibi-iṣẹ́ tí ó ní wọn, wọn kò sì fi mọ́ ẹ̀ sí ìwé ìtàn ìṣe, ìfihàn àṣìṣe tàbí ìjíròrò ìrànlọ́wọ́. Ìwé ìtàn ìṣe ń fi hàn pé ìgbésẹ̀ kan fọwọ́sí bíi supplier-sftp; kò fi hàn ohun tí supplier-sftp jẹ́.

Àgbègbè tí ó ń ṣiṣẹ́ iṣẹ́-àkánṣe kan fún àwọn oníṣẹ́ ogbìn mẹ́tàlélọgbọ̀n fún ẹ̀yà ìwọ̀n ìfọwọ́sí tirẹ̀ fún ọ̀kọ̀ọ̀kan, iṣẹ́-àkánṣe náà sì ń tọ́kasí ẹ̀yà náà kì í ṣe àṣírí náà. Yíyí bọtìnnì kan padà jẹ́ àtúnṣe kan ní ibi kanṣoṣo — èyí tí ó jẹ́ ọ̀pọ̀lọpọ̀ ìdí tí àwọn àgbègbè fi ń wá ibí.

Àlà tí ó yẹ kí o mọ̀: ọ̀nà-ẹ̀rọ tí kò ní ọ̀nà ìbánisọrọ̀ rárá — kò sí API, kò sí webhook, kò sí ibi tí wọ́n fi fáìlì sílẹ̀, kò sí nǹkan mìíràn àyáfá ẹni tí ó ń tẹ bọ́tìnnì nínú aṣàwákiri — kò lè jẹ́ kí a fi ọwọ́ ṣiṣẹ́ fún un láti ibí tàbí láti ọ̀dọ̀ ẹnikẹ́ni tí ó ń ṣiṣẹ́ pẹ̀lú òtítọ́. Kò sí aṣàwákiri tí kò ní orí tí ó ń farahàn bíi olùlò níbí, nítorí ó ń baje ní ìgbà àkọ́kọ́ tí ẹgbẹ́ kejì bá yí bọ́tìnnì kan padà, ó sì ń baje ní ìrọ̀rùn.