intro
Ma te iti o nga patene i runga i te papamahi, i te taputapu ranei, ka taea e tetahi te hoko, te hoko, te whakaputa ranei i tetahi mea, i nga wa katoa. Me pehea te tupu? Me pehea mōhiohio haere mai i konei ki reira? Ko te toa e kore e mohiotia ko te API.
He aha te API?
Ko te API e tu ana mo te Atanga KAUPAPA TONO. Ko te API e whakaatu ana i tetahi waahanga rorohiko, ona mahi, whakaurunga, putanga, me nga momo o raro. Engari me pehea e whakamarama ai koe i te API ki te reo Ingarihi? Ko te API te mahi hei karere e whakawhiti ana i to tono mai i tetahi tono me te whakahoki i te whakautu ki a koe.
Hei tauira 1: I a koe e rapu ana i nga rererangi ipurangi. Ka taunekeneke koe me te paetukutuku a te waka rererangi. Kei te paetukutuku nga korero mo te nohoanga me te utu mo te rere i tera ra me te wa. Ka whiriwhiri koe i to kai, i to nohoanga, i to peke, i to tono mokai ranei.
Engari, ki te kore koe e whakamahi i te paetukutuku tika o te waka rererangi, kei te whakamahi ranei koe i tetahi kaihoko haerenga ipurangi e whakakotahi ana i nga raraunga mai i nga kamupene rererangi maha. Ki te tiki i nga korero, ka uru tetahi tono ki te API o te waka rererangi. Ko te API te atanga hei tango raraunga mai i te paetukutuku a te kaihoko haere ki te punaha o te waka rererangi.
Ka mau ano te whakautu a te waka rererangi me te whakahoki mai ano. Ma tenei ka awhina i te taunekeneke i waenga i te ratonga haerenga, me nga punaha rererangi - ki te tuhi i te rerenga. Kei roto i te API he whare pukapuka mo nga mahinga, nga hanganga raraunga, nga karaehe ahanoa, me nga taurangi. Hei tauira, nga ratonga SOAP me te REST.
Hei tauira 2: Ko te Best Buy he utu motuhake mo te Ra mo tana paetukutuku. Ko enei raraunga ano kei roto i tana tono pūkoro. Kaore te taupānga e awangawanga mo te punaha utu o roto - ka taea te waea atu ki te Deal of the Day API me te patai, he aha te utu motuhake? Ka whakautu a Best Buy me nga korero i tonoa i roto i te whakatakotoranga paerewa ka whakaatuhia e te taupānga ki te kaiwhakamahi mutunga.
Tauira3: He mea nui nga API mo nga paapori pāpori. Ka taea e nga kaiwhakamahi te uru ki nga ihirangi me te pupuri i te maha o nga kaute me nga kupuhipa e mau ana ratou ki te iti, kia ngawari ai.
- API Twitter: Whakawhitiwhiti me te nuinga o nga mahi Twitter
- API Facebook: Mo nga utu, nga raraunga kaiwhakamahi, me te takiuru
- Instagram API: Tohua nga kaiwhakamahi, tirohia nga whakaahua o ia ra
Me pehea te REST & SOAP API's?
SOAP a te okiokinga whakamahia he ratonga kai-API, e mohiotia ana ko API Tukutuku. Ko te ratonga Tukutuku karekau i te whakawhirinaki ki tetahi mohiotanga o mua mo nga korero. Ko te SOAP he kawa ratonga tukutuku he maamaa te turanga-motuhake. Ko SOAP he kawa karere a XML. Kaore i rite ki te ratonga tukutuku SOAP, ka whakamahia e te ratonga Restful te hoahoanga REST, i hangaia mo te whakawhitiwhiti korero-a-ira.
Ratonga Tukutuku SOAP
- SOAP Kaituku – te hanga me te tuku karere.
- Kaiwhiwhi SOAP – whiwhi me te tukatuka i te karere.
- SOAP Intermediary- ka whiwhi me te tukatuka i nga poraka pane.
Ratonga Tukutuku ONOA
Representational State Transfer (REST) e pa ana ki te hononga i waenga i te kiritaki me te tūmau me te pehea o te whakahaere a te kawanatanga. Ko te hoahoanga okiokinga, ko te REST Server ka whakarato rauemi uru ki te kiritaki. Ko te okiokinga ka mau i te panui me te whakarereke, te tuhi ranei i nga rauemi. Ko te Uniform Identifier (URI) ka tautuhi i nga rauemi hei pupuri i tetahi tuhinga. Ma tenei ka hopu i te ahua rauemi.
He mama ake te REST i te hoahoanga SOAP. Ka paopaohia e ia a JSON, he reo ka taea e te tangata te panui e taea ai te tiri raraunga me te ngawari ki te whakamahi raraunga, hei utu mo te XML e whakamahia ana e te hoahoanga SOAP.
He maha nga maataapono mo te hoahoa i te Restful Web Service, ara:
- Te Whakataunga - Kia kotahi te URL o ia rauemi.
- Korekore - Ko te ratonga okioki he ratonga kore whenua. He tono motuhake mai i nga tono o mua a te ratonga. Ko te HTTP he kawa korekore.
- Cacheable - Ko nga raraunga kua tohua hei toa keteroki i roto i te punaha me te whakamahi ano i nga ra kei mua. Ka rite ki te whakautu ki te tono kotahi hei utu mo te whakaputa i nga hua ano. Ka taea e nga here keteroki te tohu raraunga whakautu hei keteroki, kore-keteroki ranei.
- Atanga rite - Ka taea e te atanga noa me te paerewa te whakamahi mo te uru. Te whakamahi i te kohinga kua tautuhia o nga tikanga HTTP. Ma te mau ki enei ariā, he mama te whakatinanatanga o REST.
Nga painga o REST
- Ka whakamahi i te whakatakotoranga ngawari ake mo nga karere
- He kaha ake te whai hua mo te wa roa
- Ka tautokohia te whakawhitiwhiti korero kore whenua
- Whakamahia nga paerewa HTTP me te wetereo
- Kei te waatea nga raraunga hei rauemi
Nga kino o REST
- Rahua i roto i nga paerewa o te ratonga Tukutuku penei i nga Whakawhitinga Haumarutanga etc.
- Ko nga tono REST e kore e taea te tauine
REST vs SOAP Whakatauritenga
Nga rereketanga i waenga i nga ratonga tukutuku SOAP me REST.
Ratonga Tukutuku SOAP | Whakaorangia Ratonga Tukutuku |
Me taumaha te utu whakauru ki te REST. | He mama te REST i te mea ka whakamahia e ia te URI mo nga puka raraunga. |
Ko nga huringa i roto i nga ratonga SOAP he maha nga huringa nui o te waehere i te taha o te kiritaki. | Ko te waehere taha-kiritaki e kore e pangia e te huringa o nga ratonga i roto i te whakaratonga tukutuku REST. |
Ko te momo whakahoki he momo XML tonu. | Ka whakarato i te whai kiko ki te ahua o nga raraunga kua whakahokia mai. |
He kawa karere a XML | He kawa hoahoanga |
Me whai whare pukapuka SOAP i te mutunga o te kiritaki. | Karekau he tautoko whare pukapuka e hiahiatia ana i runga i te HTTP. |
Tautoko WS-Haumarutanga me SSL. | Ka tautokohia te SSL me te HTTPS. |
Ka tautuhia e SOAP tana ake haumarutanga. | Ka whakawhiwhia nga ratonga tukutuku RESTful i nga tikanga haumarutanga mai i te kawe waka. |
Momo Kaupapa here Tuku API
Ko nga kaupapa here tuku mo te API ko:
Kaupapa here tuku motuhake:
Kei te waatea noa te API mo te whakamahi a te kamupene o roto.
Kaupapa here tuku hoa:
Kei te waatea te API mo etahi hoa pakihi anake. Ka taea e nga kamupene te whakahaere i te kounga o te API na te mana whakahaere mo wai ka uru atu.
Kaupapa here tuku a te iwi:
Ko te API hei whakamahi ma te iwi. Ko te waatea o nga kaupapa here tuku e waatea ana ki te marea. Tauira: Microsoft Windows API me Apple's Cocoa.
Opaniraa
Kei nga waahi katoa nga API, ahakoa kei te tono koe i te rerenga rererangi, kei te uru ranei koe ki nga tono paapori pāpori. Ko te SOAP API kei runga i nga korero XML, he rereke mai i te REST API na te mea kaore e hiahiatia he whirihoranga motuhake.
Ko te hoahoatanga o nga ratonga Tukutuku Whakanoho me u tonu ki etahi ariā, tae atu ki te urutau, te kore whenua, te keteroki, me te atanga paerewa. Ka wehewehea nga ture tuku API ki nga waahanga e toru: nga API motuhake, nga API hoa, me nga API whanui.
Mauruuru koe mo te panui i tenei tuhinga. Tirohia ta maatau tuhinga mo te Aratohu Haumarutanga API 2022.
