Intro
Me nā kaomi liʻiliʻi ma ka pākaukau a i ʻole ka mea hana, hiki i kekahi ke kūʻai, kūʻai aku a hoʻolaha paha i kekahi mea, i kēlā me kēia manawa. Pehea e hiki mai ai? Pehea ike kiʻi mai ʻaneʻi a i laila? ʻO ka mea koa i ʻike ʻole ʻia ʻo ia ka API.
He aha ka API?
API no kahi PALAPALA PALAPALA PALAPALA. Hōʻike ka API i kahi ʻāpana polokalamu, kāna hana, hoʻokomo, hoʻopuka, a me nā ʻano kumu. Akā pehea ʻoe e wehewehe ai i ka API ma ka ʻōlelo Pelekania? Hana ka API ma ke ʻano he ʻelele nāna e hoʻololi i kāu noi mai kahi noi a hoʻihoʻi i ka pane iā ʻoe.
Eia 1: Ke ʻimi nei ʻoe i nā mokulele ma ka pūnaewele. Pili ʻoe me ka punaewele o ka mokulele. Hōʻike ka pūnaewele i ka noho a me ke kumukūʻai o ka lele ma kēlā lā a me ka manawa. Koho ʻoe i kāu ʻai a i ʻole kahi noho, ʻeke, a i ʻole nā noi holoholona.
Akā, inā ʻaʻole ʻoe e hoʻohana ana i ka pūnaewele pololei o ka mokulele a i ʻole ke hoʻohana nei i kahi ʻelele huakaʻi pūnaewele e hoʻohui i ka ʻikepili mai nā mokulele he nui. No ka loaʻa ʻana o ka ʻike, pili kekahi noi me ka API o ka mokulele. ʻO ka API ka mea e lawe ai i ka ʻikepili mai ka punaewele o ka mea huakaʻi i ka ʻōnaehana o ka mokulele.
Lawe pū ia i ka pane a ka mokulele a hoʻihoʻi pololei. Kēia mea oluolu i ka launa pū ana ma waena o ka huakaʻi lawelawe, a me ka 'oihana mokulele - e puke i ka holo. Loaʻa i ka API kahi waihona no nā hana maʻamau, nā hoʻonohonoho ʻikepili, nā papa mea, a me nā mea hoʻololi. No ka laʻana, SOAP a me REST lawelawe.
Eia 2: Hana ʻo Best Buy i kahi kumukūʻai kūʻai o ka lā i loaʻa ma o kāna pūnaewele. Aia kēia ʻikepili i kāna polokalamu kelepona. ʻAʻole hopohopo ka app no ka ʻōnaehana kumu kūʻai kūloko - hiki iā ia ke kāhea i ka Deal of the Day API a nīnau, he aha ke kumu kūʻai kūikawā? Pane ʻo Best Buy me ka ʻike i noi ʻia ma kahi ʻano maʻamau i hōʻike ʻia e ka app i ka mea hoʻohana hope.
Laʻana 3: He mea koʻikoʻi nā API no ka ʻoihana pūnaewele. Hiki i nā mea hoʻohana ke komo i ka ʻike a mālama i ka helu o nā moʻokāki a me nā ʻōlelo huna a lākou e mālama ai i ka haʻahaʻa, no laila hiki iā lākou ke maʻalahi.
- Twitter API: E launa pū me ka hapa nui o nā hana Twitter
- Facebook API: No nā uku, ka ʻikepili mea hoʻohana, a me ke komo ʻana
- Instagram API: E hōʻailona i nā mea hoʻohana, e nānā i nā kiʻi ʻano
Pehea e pili ana i ka REST & SOAP API?
ke Kopa a koena hoʻohana i kahi lawelawe hoʻohana API, i kapa ʻia ʻo API Web. ʻAʻole pili ka lawelawe pūnaewele i ka ʻike mua o ka ʻike. ʻO SOAP kahi protocol lawelawe pūnaewele maʻalahi ka paepae-kūʻokoʻa. ʻO SOAP kahi protocol memo ma muli o XML. ʻAʻole like me ka lawelawe pūnaewele SOAP, hoʻohana ʻo Restful service i ka hale hoʻolālā REST, i kūkulu ʻia no ke kamaʻilio kiko-a-kahi.
lawelawe pūnaewele SOAP
- SOAP Sender - hana a hoʻouna i kahi leka.
- SOAP Loaʻa - loaʻa a hana i ka memo.
- SOAP Intermediary- loaʻa a hana i nā poloka poʻomanaʻo.
Hoʻomaha Pūnaewele Pūnaewele
ʻO ka Representational State Transfer (REST) pili i ka pilina ma waena o ka mea kūʻai aku a me ke kikowaena a me ke ʻano o ka hana ʻana o ka mokuʻāina. ʻO ka hale hoʻomaha hoʻomaha, hāʻawi kahi REST Server i ke komo waiwai i ka mea kūʻai. Mālama ʻo Rest i ka heluhelu a me ka hoʻololi a kākau ʻana paha i nā kumuwaiwai. Hoʻomaopopo ka Uniform Identifier (URI) i nā kumuwaiwai e loaʻa ai kahi palapala. E hopu kēia i ke kūlana waiwai.
ʻOi aku ka māmā o REST ma mua o ka hoʻolālā SOAP. Hoʻopili ʻo ia iā JSON, he ʻōlelo hiki ke heluhelu ʻia e ke kanaka e hiki ai i ke kaʻana like ʻana a me ka maʻalahi o ka hoʻohana ʻana i ka ʻikepili, ma kahi o XML i hoʻohana ʻia e ka hoʻolālā SOAP.
Nui nā loina no ka hoʻolālā ʻana i ka Restful Web Service, ʻo ia hoʻi:
- Loaʻa ʻia - Pono kēlā me kēia kumuwaiwai i hoʻokahi URL.
- Statelessness - ʻO kahi lawelawe hoʻomaha he lawelawe mokuʻāina. Kūʻokoʻa kahi noi mai nā noi i hala e ka lawelawe. Hoʻolālā ʻia ʻo HTTP i kahi protocol stateless.
- Cacheable - Ua hōʻailona ʻia ka ʻikepili ma ke ʻano he hale kūʻai hūnā i ka ʻōnaehana a hoʻohana hou i ka wā e hiki mai ana. E like me ka pane i ka noi like ma mua o ka hana ʻana i nā hopena like. Hiki i nā kaohi hoʻokoe ke hiki ke hōʻailona i ka ʻikepili pane ma ke ʻano he hiki ke hoʻopaʻa ʻia a i ʻole hiki ke hoʻopaʻa ʻia.
- Kūlike like ʻole - E ʻae i kahi kikowaena maʻamau a maʻamau e hoʻohana no ke komo ʻana. Ka hoʻohana ʻana i kahi hōʻiliʻili i wehewehe ʻia o nā ʻano HTTP. ʻO ka mālama ʻana i kēia mau manaʻo e hōʻoiaʻiʻo, maʻalahi ka hoʻokō REST.
Pono o REST
- Hoʻohana i ka ʻano maʻalahi no nā memo
- Hāʻawi ikaika i ka hana lōʻihi
- Kākoʻo ia i ke kamaʻilio stateless
- E hoʻohana i nā kūlana HTTP a me ka grammar
- Loaʻa ka ʻikepili ma ke ʻano he kumu
Nā pōʻino o REST
- Hāʻule i nā kūlana o ka lawelawe pūnaewele e like me Security Transactions etc.
- ʻAʻole hiki ke hoʻonui ʻia nā noi REST
Hoʻohālikelike REST vs SOAP
Nā ʻokoʻa ma waena o nā lawelawe pūnaewele SOAP a me REST.
Hana Pūnaewele SOAP | Hoʻomaha Pūnaewele Pūnaewele |
Pono ka uku hoʻokomo kaumaha i hoʻohālikelike ʻia me REST. | He māmā ka REST no ka mea e hoʻohana ana i ka URI no nā palapala ʻikepili. |
Hoʻololi pinepine i nā lawelawe SOAP i kahi hoʻololi nui i ka code ma ka ʻaoʻao o ka mea kūʻai aku. | ʻAʻole pili ka code ʻaoʻao o nā mea kūʻai aku e ka hoʻololi ʻana i nā lawelawe i ka hoʻolako pūnaewele REST. |
He ʻano XML mau ke ʻano hoʻihoʻi. | Hāʻawi i ka versatility e pili ana i ke ʻano o ka ʻikepili i hoʻihoʻi ʻia. |
He protocol memo ma muli o XML | ʻO kahi protocol kūkulu hale |
Pono i kahi waihona SOAP ma ka hope o ka mea kūʻai. | ʻAʻohe kākoʻo waihona i hoʻohana maʻamau ma luna o HTTP. |
Kākoʻo iā WS-Security a me SSL. | Kākoʻo iā SSL a me HTTPS. |
Ua wehewehe ʻo SOAP i kona palekana ponoʻī. | Loaʻa nā lawelawe pūnaewele RESTful i nā ana palekana mai ka lawe ʻana i lalo. |
Nā ʻano o nā kulekele hoʻokuʻu API
ʻO nā kulekele hoʻokuʻu no API:
Nā kulekele hoʻokuʻu pilikino:
Loaʻa ka API no ka hoʻohana ʻana i ka ʻoihana kūloko.
Nā kulekele hoʻokuʻu hoa:
Loaʻa ka API no nā hoa pili ʻoihana. Hiki i nā hui ke hoʻomalu i ka maikaʻi o ka API ma muli o ka mana o ka mea hiki ke komo.
Nā kulekele hoʻokuʻu lehulehu:
No ka lehulehu ka API. Loaʻa ka loaʻa o nā kulekele hoʻokuʻu i ka lehulehu. Laʻana: Microsoft Windows API a me Apple's Cocoa.
Panina
Aia nā API ma nā wahi a pau, inā paha ʻoe e hoʻopaʻa nei i kahi mokulele a i ʻole ke komo pū ʻana me nā noi media. Hoʻokumu ʻia ka SOAP API ma nā kamaʻilio XML, ʻokoʻa ia mai ka REST API no ka mea ʻaʻole ia e koi i kahi hoʻonohonoho kūikawā.
Pono ka hoʻolālā ʻana i nā lawelawe Pūnaewele hoʻomaha i kekahi mau manaʻo, e pili ana i ka addressability, statelessness, cacheability, a me kahi interface maʻamau. Hiki ke hoʻokaʻawale ʻia nā lula hoʻokuʻu API i ʻekolu mau ʻāpana: nā API pilikino, nā API hoa, a me nā API lehulehu.
Mahalo iā ʻoe no ka heluhelu ʻana i kēia ʻatikala. E nānā i kā mākou ʻatikala ma kahi alakaʻi Palekana API 2022.