E te manaʻo e faʻafesoʻotaʻi lau app i le Facebook ina ia mafai ai ona faʻapipiʻi faʻasalalauga, poʻo le Instagram ina ia mafai ona e toe faʻapipiʻi ata ma ni hashtags?
E mafai fo'i ona e mana'o e fa'aaofia vitio YouTube i lau 'upega tafa'ilagi. O fesoʻotaʻiga polokalame faʻaoga e mafai ai ona e faʻatinoina uma nei galuega ma isi mea (API).
O talosaga eseese e mafai ona "tautala" le tasi i le isi i se tulaga saogalemu ma faʻasalalau faʻafetai i API pei o le Instagram API, Facebook API, ma le YouTube API.
I se isi faaupuga, e mafai e se polokalame ona ave faʻamatalaga poʻo faʻamatalaga mai se isi vaega o polokalama ma faʻaaogaina e faʻaleleia ai ona lava foliga poʻo le poto masani o tagata faʻaoga. Ae fa'afefea ona faia e polokalame nei talosaga, fa'agasolo, ma tali atu i se faiga e malamalama ai isi?
E fa'alagolago i le auala na faia ai le API. Pe a talanoaina le API (appplication programming interface), e masani lava ona faʻatusatusa SOAP vs. REST, e lua o faʻataʻitaʻiga API sili ona lauiloa.
O le taimi lava na avea ai SOAP APIs (Simple Object Access Protocol) ma tulaga auro mo kamupani e pei o Oracle, Sun, ma PayPal, sa i ai se tali tutusa ma le faafeagai i le tausaga pe mulimuli ane agai i REST API mai Google, Amazon, ma eBay.
I lenei pou, matou te fa'atusatusa ma fa'atusatusa SOAP API ma REST APIs ina ia mafai ai ona e filifili po'o fea e sili mo ou fa'amoemoega.
O le a tatou amata i le faʻamalamalamaina o le API.
O le a le API?
Application Programming Interface e taʻua o le API. API o se aofaʻiga o metotia ma galuega e mafai ai ona atinaʻe polokalame. Latou te maua avanoa i faʻamatalaga ma galuega a polokalame eseese, auaunaga, poʻo faiga faʻaoga.
Latou te auauna atu o se ituaiga tagata vaeluagalemu i le va o polokalama eseese polokalama. Latou te mafaia le "talanoa" i le va o polokalame e lua e leʻi fesoʻotaʻi.
Seʻi o tatou faia se faʻataʻitaʻiga o se tagata faʻatau oloa o loʻo galue malosi i fefaʻatauaiga ma maketi tau tupe. O se fa'aputuga o mea fa'apitoa fefa'ataua'iga algorithms e mafai ona fa'afeso'ota'i i le fa'ailoga fefa'ataua'iga e sili ona fiafia i ai le faioloa e ala ile API. Ole mea lea e mafai ai e oe, le faioloa, ona fa'atino fefa'ataua'iga fa'aeletonika pe va'ai i fa'amatalaga fa'a-taimi ma fa'amatalaga tau.
O le a le MOTO?
O API moni “auaunaga i luga ole laiga” e aofia ai le REST (Representational State Transfer). REST API e fausia i luga o URI (Uniform Resource Identifiers, lea o le URL o se ituaiga faʻapitoa), le HTTP protocol, ma le faʻaogaina o faʻamatalaga faʻamaumauga a le JSON.
O le SOAP protocol, e pei ona matou taʻua muamua, e mafai foi ona faʻaaogaina. REST API e mafai ona faigofie ona fausia ma tuputupu ae, ae e mafai foi ona tetele ma faigata—e faalagolago uma lava i le auala e faia ai, faalautele, ma mea e faamoemoe e fai.
Fa'atapula'aina o puna'oa, fa'aitiitia mana'oga mo le puipuiga, feso'ota'iga a tagata su'esu'e su'esu'e, mafai ona maua, soifua maloloina o fa'amaumauga, ma le fa'alauteleina o nisi ia o mafua'aga e te mana'o ai e atia'e se API ina ia MAMAFAGA—o mea e fa'atatau tonu i auaunaga i luga ole laiga.
REST e ofoina atu se filifiliga e sili atu le mama. O le SOAP sa faigata ona faʻaaogaina ma mamafa i le tele o atinaʻe. Mo se faʻataʻitaʻiga, o le faʻaaogaina o le SOAP ma le JavaScript e manaʻomia le tusiaina o le tele o code e faʻamaeʻa ai galuega faigofie talu ai e tatau ona faia le fausaga XML talafeagai i taimi uma.
REST (masani) fa'aogaina se URL tuusa'o e suitulaga i se talosaga XML. E ui lava e iai ni tulaga e le masani ai e tatau ai ona e ofoina atu nisi faʻamatalaga, o le tele o auaunaga i luga o le upega tafaʻilagi a le RESTful e faʻaaogaina le auala URL.
O veape HTTP 1.1 e fa GET, POST, PUT, ma DELETE e mafai ona faʻaogaina e le REST e faʻatino ai galuega. E le pei o SOAP, REST e le manaʻomia le tali i totonu XML.
'Au'aunaga i luga o le upega tafa'ilagi REST e maua ai fa'amaumauga i le Poloaiga Separated Value (CSV), JavaScript Object Notation (JSON), ma Really Simple Syndication (RSS) formats e maua (RSS).
O le fa'amoemoe e mafai ona e maua fa'ai'uga e te mana'omia i se fa'avasegaga faigofie i le gagana o lo'o e fa'aogaina mo lau talosaga.
Features
- O le REST e faʻamamafaina le faigofie nai lo isi mea uma, ona o HTTP protocols.
- O le upega tafa'ilagi e sili ona fetaui mo MOTO. E fetaui ma tagata su'esu'e ona o le JSON o lo'o fa'aaogaina e fai ma fa'amaumauga fa'amaumauga.
- E ta'uta'ua le REST i lona fa'amatagofieina ma le saoasaoa.
- O feso'ota'iga Client-server ma faufale ua fa'afaigofie ona maua e REST API. Afai o le RESTful, e fau i le fa'ata'ita'iga lea o le client-server, fa'atasi ai ma malaga taamilo i le va o itu e lua e pasia ai fa'amaumauga.
- REST APIs e fa'aogaina se fa'aoga tulaga masani. Fa'amautinoaina o lo'o feso'ota'i fa'atasi uma polokalame ma e ui atu i le faitoto'a lava e tasi, fa'afaigofie le auala e feso'ota'i ai tusi talosaga ma le API.
O le a le SOAP?
O lana lava feagaiga, e ta'ua o le SOAP (Simple Object Access Protocol), e fai si lavelave nai lo le REST talu ai o lo'o fa'ama'oti mai ai le tele o tulaga, e aofia ai ma mea e feso'ota'i ma le saogalemu ma le tu'uina atu o fe'au.
O nei tulaga masani e sau ma sina fa'aopoopoga fa'aopoopo. Ae ui i lea, e mafai ona avea ma mea taua mo pisinisi e manaʻomia le sili atu le saogalemu, fefaʻatauaʻiga, ma le ACID (Atomicity, Consistency, Isolation, Durability) gafatia tausisia.
Mo le lelei o lenei faʻatusatusaga, e taua le matauina o le tele o faʻamanuiaga o le SOAP e le masani ona faʻaogaina i luga o le upega tafaʻilagi talosaga, e faʻafaigofie ai mo faʻataʻitaʻiga-ituaiga atinaʻe.
O tikeri maualuga o le saogalemu (e pei o le a polokalama feaveai fegalegaleai ma se faletupe), polokalame fe'au e mana'omia ai feso'ota'iga fa'alagolago, fegalegaleai ma faiga fa'aleaganu'u, po'o le tausisia o le ACID o nai mafua'aga ia e te mana'o ai e mamanuina se talosaga e fa'aoga ai le SOAP API.
Ole agava'a fe'au na ofoina mai e le SOAP e fa'avae atoa ile XML. O tekonolosi tuai e le talafeagai i luga ole laiga e pei ole Distributed Component Object Model (DCOM) ma le Common Object Request Broker Architecture na suia e le SOAP i le taimi muamua na faia ai e Microsoft (CORBA).
O le faʻalagolago i fesoʻotaʻiga binary e mafua ai ona toilalo nei faiga. I luga o le initaneti, o feʻau XML pei o le faʻaaogaina e le SOAP e sili atu ona lelei.
Features
- O le saogalemu o le SOAP e matua sili atu ona malu. WS-Security o se faʻataʻitaʻiga faʻapipiʻiina lea e ofoina atu le SOAP faʻaopoopo le gafatia o le puipuiga o atinaʻe pe a manaʻomia e faʻaopoopo i le lagolago SSL.
- Manuia/toe taumafai fa'atatau mo le fa'atinoina o fe'au fa'amaoni. Talu ai o le REST e leai se fa'atonuga o fe'au, e mafai ona toe taumafai pe a le manuia feso'ota'iga. E tusa lava pe faʻaaogaina SOAP intermediates, SOAP e ofoina atu le faʻalagolago i le pito i luga ona o lona faʻaogaina manuia / toe taumafai faʻatatau.
- O LE SOAP ua uma ona tausisia tulaga ACID. E ala i le fa'atonuina pe fa'afefea ona fegalegaleai fefa'ataua'iga ma le fa'amaumauga, o le tausisia e le ACID e fa'aitiitia ai fa'aletonu ma puipuia ai le tutusa o se fa'amaumauga. Talu ai e sili atu le fa'aeteete o le ACID nai lo isi fa'ata'ita'iga fa'atutusa o fa'amaumauga, e masani ona fa'aaogaina pe a fa'atautaia fefa'ataua'iga ma'ale'ale, pe tautupe po'o isi mea.
- E faigofie mo tagata fai polokalame ona malamalama talu ai o le SOAP o se fesoʻotaʻiga faʻavae XML.
- O le XML feʻau faʻasalalauga o se faʻaopoopoga i le HTTP protocol.
- Feso'ota'iga mai le tasi komepiuta i le isi komepiuta e mafai ona fa'asalalauina e ala i fe'au SOAP.
- E mafai fo'i ona fa'atinoina le fausaga o tagata fa'atau-server. E mafai ona fa'aogaina e le kalani se fe'au fa'akomepiuta SOAP e vala'au ai se vala'au mamao o lo'o tu i le itu-aumau.
MAFAGA Vs Vs SOAP Eseesega
1. Faʻafanua
O se API e fa'amoemoe e fa'aalia ai vaega fa'apitoa o le fa'atatau pisinisi o se talosaga i luga o se 'au'aunaga. A'o fa'aogaina e le REST URI mo le fa'amoemoe lava e tasi, o lo'o fa'aaogaina e le SOAP se Fa'amatalaga Au'aunaga mo lenei mea.
REST API e faia pe a uma faʻamaumauga, ae o SOAP API e atiaʻe pe a maeʻa galuega o loʻo faʻaalia e le API. Pe a faʻatusatusa i le SOAP, lea e sili atu le faʻatinoina o galuega, REST o se faʻataʻitaʻiga sili atu faʻamaumauga.
2. Taʻitaʻia
O fa'amaumauga ua fa'ailogaina e mafai ona fa'aogaina e mafai ona toe fa'aogaina e tagata su'esu'e e aunoa ma le mana'omia latou e fai se talosaga fou i le 'au'aunaga. O le faasaoina o le taimi ma taumafaiga o se aogā lea o lenei mea.
O tali o le a le teuina i le HTTP tulaga talu ai SOAP fesili e tuʻuina atu e ala ile POST talosaga, lea e manatu le HTTP e le faʻaleagaina. Afai e te manaʻo e faʻafaigaluegaina le faʻaogaina, e tatau lava ona e fausia auala talafeagai aua REST API e le aofia ai lenei faʻatinoga.
3. Punaoa & Bandwidth
Ona o le fa'aliliuina o uta o teutusi e fa'aaogaina e le SOAP, o lo'o i ai se si'itaga la'ititi i luga ole ulu, lea e mana'omia ai le fa'aopoopoina o le bandwidth. Ole natura mama ole REST ose fa'amanuiaga ile tulaga nei aua e masani ona fa'aoga mo auaunaga i luga ole laiga.
4. Puipuiga
WS-saogalemu, lea e lagolagoina e le SOAP ma e sili atu ona maeʻa nai lo SSL i le tulaga o felauaiga, e manaʻomia. O le tu'ufa'atasia o faiga fa'apolofesa tulaga tau atina'e fa'atasi ai ma se mea e fetaui lelei.
Fa'ailoga pito i tua e fa'aaoga ai le SSL o lo'o lagolagoina e SOAP ma REST, ma e mafai e le REST ona fa'aoga HTTPS, o le suiga mautu o le HTTP protocol.
5. Taulimaina o Totogi
O faʻamatalaga e tuʻuina atu i luga ole Initaneti ua taʻua o se uta. O se uta e manatu e "mamafa" e manaʻomia ni punaoa faaopoopo. Fa'atusatusa i le SOAP, lea e fa'aogaina ai le XML, e masani ona fa'aogaina e le REST le JSON ma le HTTP e fesoasoani ai e fa'aitiitia le uta.
O se faletusi fa'apitoa a le Client ma fa'ailoga fa'atupu e tatau ona fa'aaoga masani e le Client e fa'aoga ai SOAP API ona o le latou konekarate tau feso'ota'iga.
O se taunuuga, o le SOAP e ofoina atu se laʻititi laʻititi o le faʻaaogaina nai lo le REST ma e sili atu ona vavalalata ma le server.
O afea e fa'aoga ai le REST?
- Fausia APIs lautele: REST API e sili ona lelei mo le fausiaina o auaunaga i luga o le upega tafaʻilagi a le lautele aua e vaʻaia e sili atu ona faigofie ona faʻaoga ma faʻaaogaina nai lo SOAP API. E le gata i lea, o le SOAP o loʻo ofoina atu le tele o mea e puipuia ai e le maua e le REST, e ui o nei uiga e le manaʻomia pe a galue ma faʻamatalaga matala ma auaunaga.
- Fausiaina o polokalama feaveaʻi: REST e lelei atoatoa mo le fausiaina o talosaga feaveaʻi talu ai e laʻititi, aoga, leai ni setete, ma e mafai ona faʻaogaina.
- Fa'aaogāga utiuti 'au'aunaga ma bandwidth: O talosaga uma i se REST API e tatau ona leai ni setete, o lona uiga o fegalegaleaiga taʻitasi e eseese ma o talosaga taʻitasi ma tali o loʻo i ai faʻamatalaga uma e manaʻomia e faʻamaeʻa ai lena fegalegaleaiga. E le fa'asaoina e le 'au'aunaga fa'amaumauga o talosaga muamua talu ai e fa'aogaina ia mea ta'itasi o se talosaga fou. O se taunuuga, e manaʻomia e le 'auʻaunaga le itiiti ifo o le manatua ma faʻagaoioi vave ona o se talosaga e le manaʻomia se isi gaioiga poʻo le toe maua mai o faʻamaumauga faʻasolopito.
O afea e fa'aoga ai le SOAP?
- Fausia API tumaoti, aemaise lava mo pisinisi tetele: SOAP e lelei atoatoa mo faʻasalalauga faʻapitoa talu ai e mafai ai ona tafe faʻamatalaga i totonu o se siosiomaga faʻasalalau, tufatufaina ma o loʻo i ai le tele o mea saogalemu i luga ole laiga.
- Fa'aaogāina ose felauaiga e ese mai le HTTP e fai ma fa'avae fa'avae: SOAP e le faʻalagolago ile HTTP o le faʻavae autu. Fa'alagolago i lau talosaga, e mafai ona e fa'aogaina le SMTP (Simple Mail Transfer Protocol), JMS (Java Messaging Service), po'o se isi felauaiga.
- Galulue faʻatasi ma gaioiga faʻatulafonoina: E ese mai i talosaga ile REST APIs, ole talosaga ile SOAP API e faʻamaonia, o lona uiga e faʻasaoina e le server faʻamatalaga e uiga i le kalani ma faʻaogaina i luga o se filifili o talosaga poʻo gaioiga. E tusa lava pe faʻaogaina e lenei mea le tele o bandwidth server ma punaoa, e taua tele mo le faʻatinoina o gaioiga masani poʻo fesoʻotaʻiga, pei o le fesiitaiga o faletupe.
iʻuga
O le fa'atusatusaga i le va o le REST ma le SOAP API e fa'amaonia ai o le REST e sili atu nai lo SOAP. Ae ui i lea, e iai tulaga e manaʻomia ai le SOAP API. I nisi taimi, o 'au'aunaga i luga ole laiga e faia ile tu'ufa'atasiga ole REST ma SOAP API.
O le mea lea, o le faʻaoga faʻaoga o le a fuafua po o le fea API e sili ona aoga.
Tuua se tali