Intro
Kwa kubofya mara chache kwenye eneo-kazi au kifaa, mtu anaweza kununua, kuuza au kuchapisha chochote, wakati wowote. Inatokeaje hasa? Jinsi gani habari kutoka hapa hadi pale? Shujaa asiyetambulika ni API.
API ni nini?
API inasimama kwa INTERFACE YA KUPANGA MAOMBI. API inaonyesha kipengele cha programu, uendeshaji wake, pembejeo, matokeo, na aina za msingi. Lakini unaelezeaje API kwa Kiingereza wazi? API hufanya kazi kama mjumbe anayehamisha ombi lako kutoka kwa programu na kukuletea jibu.
Mfano 1: Unapotafuta safari za ndege mtandaoni. Unaingiliana na tovuti ya shirika la ndege. Tovuti inaeleza mahali na gharama ya safari ya ndege katika tarehe na saa hiyo. Unachagua chakula chako au viti, mizigo, au maombi ya kipenzi.
Lakini, ikiwa hutumii tovuti ya moja kwa moja ya shirika la ndege au na unatumia wakala wa usafiri mtandaoni anayechanganya data kutoka kwa mashirika mengi ya ndege. Ili kupata maelezo, programu huingiliana na API ya shirika la ndege. API ni kiolesura ambacho huchukua data kutoka kwa tovuti ya wakala wa usafiri hadi kwenye mfumo wa shirika la ndege.
Pia huchukua majibu ya shirika la ndege na kuwasilisha mara moja. Hii hurahisisha mwingiliano kati ya huduma ya usafiri, na mifumo ya shirika la ndege -ya kuweka nafasi ya safari ya ndege. API inajumuisha maktaba ya utaratibu, muundo wa data, madarasa ya vitu, na anuwai. Kwa mfano, huduma za SOAP na REST.
Mfano 2: Best Buy hufanya bei ya Ofa ya Siku kuwa maalum kupitia tovuti yake. Data hii iko katika programu yake ya simu. Programu haina wasiwasi kuhusu mfumo wa bei wa ndani - inaweza kuita API ya Mpango wa Siku na kuuliza, bei ni ipi maalum? Best Buy hujibu kwa maelezo yaliyoombwa katika umbizo la kawaida ambalo programu huonyesha kwa mtumiaji wa mwisho.
Mfano3: API za mitandao ya kijamii ni muhimu. Watumiaji wanaweza kufikia maudhui na kuweka idadi ya akaunti na manenosiri wanayofuatilia chini, ili waweze kuweka mambo rahisi.
- Twitter API: Kuingiliana na vipengele vingi vya Twitter
- Facebook API: Kwa malipo, data ya mtumiaji, na kuingia
- Instagram API: Watumiaji tag, tazama picha zinazovuma
Je kuhusu REST & SOAP API's?
SOAP na WALIOBAKI tumia huduma inayotumia API, inayojulikana kama API ya Wavuti. Huduma ya wavuti haitegemei maarifa yoyote ya hapo awali ya habari. SOAP ni itifaki ya huduma ya wavuti ambayo ni nyepesi inayojitegemea kwa jukwaa. SOAP ni itifaki ya utumaji ujumbe inayotegemea XML. Tofauti na huduma ya wavuti ya SOAP, huduma ya Restful hutumia usanifu wa REST, uliojengwa kwa mawasiliano ya uhakika.
Huduma ya wavuti ya SOAP
- Mtumaji wa SOAP - kuunda na kusambaza ujumbe.
- Mpokeaji wa SABUNI - hupata na kuchakata ujumbe.
- SOAP Intermediary- hupokea na kuchakata vitalu vya vichwa.
Huduma ya Wavuti yenye RESTful
Uhamisho wa Jimbo la Uwakilishi (REST) unahusiana na uhusiano kati ya mteja na seva na jinsi hali inavyochakata. Usanifu wa mapumziko, Seva ya REST hutoa ufikiaji wa rasilimali kwa mteja. Mapumziko hushughulikia usomaji na kurekebisha au kuandika nyenzo. Kitambulisho Sare (URI) hutambua nyenzo za kuwa na hati. Hii itakamata hali ya rasilimali.
REST ni nyepesi kuliko usanifu wa SOAP. Inachanganua JSON, lugha inayoweza kusomeka na binadamu ambayo huwezesha kushiriki data na kutumia data kwa urahisi, badala ya XML inayotumiwa na usanifu wa SOAP.
Kuna kanuni kadhaa za kubuni Huduma ya Wavuti yenye utulivu, ambayo ni:
- Uwezo wa kushughulikia - Kila nyenzo inapaswa kuwa na angalau URL moja.
- Kutokuwa na utaifa - Huduma yenye utulivu ni huduma isiyo na utaifa. Ombi ni huru kwa maombi yoyote ya awali ya huduma. HTTP ni kwa muundo wa itifaki isiyo na uraia.
- Inaakibishwa - Data iliyotiwa alama kama hifadhi zinazoweza kuakibishwa kwenye mfumo na itatumika tena katika siku zijazo. Kama jibu la ombi sawa badala ya kutoa matokeo sawa. Vizuizi vya akiba huwezesha data ya majibu kuashiria kama inaweza kuakibishwa au isiyoweza kuakibishwa.
- Kiolesura cha sare - Huruhusu kiolesura cha kawaida na sanifu kutumia kwa ufikiaji. Matumizi ya mkusanyiko uliobainishwa wa mbinu za HTTP. Kuzingatia dhana hizi huhakikisha, utekelezaji wa REST ni mwepesi.
Faida za REST
- Hutumia umbizo rahisi kwa ujumbe
- Inatoa ufanisi zaidi wa muda mrefu
- Inasaidia mawasiliano yasiyo na uraia
- Tumia viwango vya HTTP na sarufi
- Data inapatikana kama nyenzo
Hasara za REST
- Inashindwa katika viwango vya huduma ya Wavuti kama vile Miamala ya Usalama n.k.
- Maombi ya REST hayawezi kuongezwa
REST dhidi ya Ulinganisho wa SABUNI
Tofauti kati ya huduma za wavuti za SOAP na REST.
Huduma ya Wavuti ya SABUNI | Huduma ya Wavuti ya kupumzika |
Inahitaji upakiaji mzito wa pembejeo ikilinganishwa na REST. | REST ni nyepesi kwani hutumia URI kwa fomu za data. |
Mabadiliko katika huduma za SOAP mara nyingi husababisha mabadiliko makubwa ya msimbo kwa upande wa mteja. | Msimbo wa upande wa mteja hauathiriwi na mabadiliko katika huduma katika utoaji wa wavuti wa REST. |
Aina ya kurejesha daima ni aina ya XML. | Hutoa matumizi mengi kuhusiana na aina ya data iliyorejeshwa. |
Itifaki ya ujumbe wa XML | Itifaki ya usanifu |
Inahitaji maktaba ya SOAP mwisho wa mteja. | Hakuna usaidizi wa maktaba unaohitajika kutumika kwa kawaida kupitia HTTP. |
Inasaidia WS-Security na SSL. | Inaauni SSL na HTTPS. |
SABUNI inafafanua usalama wake yenyewe. | Huduma tulivu za wavuti hurithi hatua za usalama kutoka kwa usafiri wa msingi. |
Aina za Sera za Utoaji wa API
Sera za kutolewa kwa API ni:
Sera za uchapishaji wa kibinafsi:
API inapatikana kwa matumizi ya ndani ya kampuni pekee.
Sera za kutolewa kwa washirika:
API inapatikana tu kwa washirika fulani wa biashara. Kampuni zinaweza kudhibiti ubora wa API kwa sababu ya udhibiti wa nani anayeweza kuipata.
Sera za kutolewa kwa umma:
API ni ya matumizi ya umma. Upatikanaji wa sera za uchapishaji unapatikana kwa umma. Mfano: Microsoft Windows API na Apple's Cocoa.
Hitimisho
API zipo kila mahali, iwe unahifadhi safari ya ndege au unajihusisha na programu za mitandao ya kijamii. SOAP API inategemea mawasiliano ya XML, inatofautiana na REST API kwa kuwa haihitaji usanidi wowote maalum.
Kubuni huduma za Wavuti Papumziko kunapaswa kuzingatia dhana fulani, ikijumuisha uwezo wa kushughulikiwa, kutokuwa na uraia, akiba, na kiolesura cha kawaida. Sheria za utoaji wa API zinaweza kugawanywa katika kategoria tatu: API za kibinafsi, API za washirika, na API za umma.
Asante kwa kusoma makala hii. Angalia nakala yetu juu ya Mwongozo wa Usalama wa API 2022.
