Intro
Uban sa pipila ka mga pag-klik sa usa ka desktop o device, ang usa mahimong makapalit, makabaligya o magmantala sa bisan unsa, bisan kanus-a. Sa unsang paagi kini mahitabo? Unsaon impormasyon gikan dinhi hangtod didto? Ang wala mailhi nga bayani mao ang API.
Unsa ang API?
Ang API nagbarog alang sa usa ka APPLICATION PROGRAMMING INTERFACE. Ang usa ka API nagpahayag sa usa ka bahin sa software, ang mga operasyon niini, mga input, mga output, ug ang mga tipo niini. Apan giunsa nimo pagpatin-aw ang API sa yano nga English? Ang API naglihok isip usa ka mensahero nga nagbalhin sa imong hangyo gikan sa usa ka aplikasyon ug naghatod sa tubag balik kanimo.
Pananglitan 1: Kung nangita ka ug mga flight online. Makig-interact ka sa website sa airline. Ang website nagdetalye sa lingkoranan ug ang gasto sa paglupad sa maong partikular nga petsa ug oras. Gipili nimo ang imong pagkaon o lingkoranan, bagahe, o mga hangyo sa binuhi.
Apan, kung wala ka naggamit sa direktang website sa airline o ug naggamit sa usa ka online travel agent nga naghiusa sa datos gikan sa daghang mga airline. Aron makuha ang kasayuran, ang usa ka aplikasyon nakig-uban sa API sa eroplano. Ang API mao ang interface nga nagdala sa datos gikan sa website sa travel agent ngadto sa sistema sa airline.
Gikuha usab niini ang tubag sa eroplano ug gihatud dayon. Gipadali niini ang interaksyon tali sa serbisyo sa pagbiyahe, ug mga sistema sa eroplano - aron ma-book ang paglupad. Ang API nag-apil sa usa ka librarya alang sa mga naandan, istruktura sa datos, mga klase sa butang, ug mga variable. Pananglitan, SOAP ug REST nga mga serbisyo.
Pananglitan 2: Ang Best Buy naghimo sa usa ka Deal of the Day nga pagpresyo nga espesyal nga magamit pinaagi sa website niini. Kining sama nga datos anaa sa mobile application niini. Ang app dili nabalaka bahin sa internal nga sistema sa pagpresyo - mahimo kini nga tawagan ang Deal of the Day API ug mangutana, unsa ang espesyal nga presyo? Ang Best Buy nagtubag sa gihangyo nga impormasyon sa usa ka standard nga format nga gipakita sa app ngadto sa end-user.
Pananglitan3: Ang mga API alang sa social media hinungdanon. Ang mga tiggamit maka-access sa sulod ug makatipig sa gidaghanon sa mga account ug mga password nga ilang gisubay nga ubos, aron ilang mahuptan nga simple ang mga butang.
- Twitter API: Pakig-interact sa kadaghanan sa mga function sa Twitter
- Facebook API: Para sa pagbayad, data sa user, ug pag-login
- Instagram API: Tag ang mga tiggamit, tan-awa ang nag-trending nga mga litrato
Unsa ang mahitungod sa REST & SOAP API's?
sabon ug PAHULAY gamita ang serbisyo nga naggamit sa API, nga nailhan nga Web API. Ang serbisyo sa web wala magdepende sa bisan unsang naunang kahibalo sa impormasyon. Ang SOAP usa ka web service protocol nga gaan nga platform-independente. Ang SOAP kay XML-based messaging protocol. Dili sama sa SOAP nga serbisyo sa web, ang Restful nga serbisyo naggamit sa REST nga arkitektura, nga gitukod alang sa point-to-point nga komunikasyon.
SOAP Web nga serbisyo
- SOAP Sender – paghimo ug pagpadala og mensahe.
- SOAP Receiver – nagkuha ug nagproseso sa mensahe.
- SOAP Intermediary- nakadawat ug nagproseso sa mga block sa header.
MAHAYONG Web Service
Ang Representational State Transfer (REST) adunay kalabotan sa relasyon tali sa kliyente ug sa server ug kung giunsa ang proseso sa estado. Ang arkitektura sa pahulay, ang usa ka REST Server naghatag ug resource access sa kliyente. Ang pahulay nagdumala sa pagbasa ug pag-usab o pagsulat sa mga kapanguhaan. Ang Uniform Identifier (URI) nagpaila sa mga kahinguhaan nga adunay sulod nga dokumento. Makuha niini ang kahimtang sa kahinguhaan.
Ang REST mas gaan kaysa SOAP nga arkitektura. Gi-parse niini ang JSON, usa ka lengguwahe nga mabasa sa tawo nga makapaarang sa pagpaambit sa datos ug dali nga magamit ang datos, imbes nga XML nga gigamit sa arkitektura sa SOAP.
Adunay daghang mga prinsipyo sa pagdesinyo sa Restful Web Service, nga mao ang:
- Addressability - Ang matag kapanguhaan kinahanglan adunay labing menos usa ka URL.
- Statelessness - Ang usa ka Restful nga serbisyo usa ka stateless nga serbisyo. Ang usa ka hangyo kay independente sa bisan unsang nangaging mga hangyo sa serbisyo. Ang HTTP kay nagdesinyo ug stateless protocol.
- Cacheable - Ang datos nga gimarkahan isip cacheable nga mga tindahan sa sistema ug magamit pag-usab sa umaabot. Ingon nga tubag sa parehas nga hangyo imbes nga maghimo parehas nga mga sangputanan. Ang mga pagpugong sa cache makahimo sa pagmarka sa datos sa tubag isip cacheable o non-cacheable.
- Uniform interface - Nagtugot sa usa ka komon ug standardized interface nga gamiton alang sa access. Ang paggamit sa usa ka piho nga koleksyon sa mga pamaagi sa HTTP. Ang pagsunod sa kini nga mga konsepto nagsiguro, ang pagpatuman sa REST gaan.
Mga bentaha sa REST
- Naggamit ug mas simple nga pormat para sa mga mensahe
- Nagtanyag og mas lig-on nga long-term efficiency
- Gisuportahan niini ang walay estado nga komunikasyon
- Gamita ang mga sumbanan sa HTTP ug gramatika
- Anaa ang datos isip usa ka kapanguhaan
Mga disbentaha sa REST
- Napakyas sa mga sumbanan sa serbisyo sa Web sama sa Security Transactions etc.
- Ang mga hangyo sa REST dili masukod
REST vs SOAP Pagtandi
Mga kalainan tali sa SOAP ug REST nga serbisyo sa web.
SOAP Web Service | Rest Web Service |
Nagkinahanglan og bug-at nga input payload itandi sa REST. | Ang REST gaan tungod kay naggamit kini og URI alang sa mga porma sa datos. |
Ang pagbag-o sa mga serbisyo sa SOAP kanunay nga nagdala sa usa ka hinungdanon nga pagbag-o sa code sa bahin sa kliyente. | Ang code sa kilid sa kliyente dili apektado sa pagbag-o sa mga serbisyo sa REST web provisioning. |
Ang tipo sa pagbalik kanunay nga tipo sa XML. | Naghatag ug versatility may kalabotan sa porma sa gibalik nga datos. |
Usa ka XML-based message protocol | Usa ka protocol sa arkitektura |
Nagkinahanglan og SOAP library sa katapusan sa kliyente. | Wala'y gikinahanglan nga suporta sa librarya nga kasagarang gigamit sa HTTP. |
Nagsuporta sa WS-Security ug SSL. | Nagsuporta sa SSL ug HTTPS. |
Ang SOAP naghubit sa kaugalingon nga seguridad. | Ang pahulay nga mga serbisyo sa web makapanunod sa mga lakang sa seguridad gikan sa nagpahiping transportasyon. |
Mga Matang sa API Release Policy
Ang mga palisiya sa pagpagawas alang sa API mao ang:
Pribado nga mga palisiya sa pagpagawas:
Ang API anaa lamang alang sa internal nga paggamit sa kompanya.
Mga palisiya sa pagpagawas sa kauban:
Ang API anaa lamang sa partikular nga mga kauban sa negosyo. Makontrol sa mga kompanya ang kalidad sa API tungod sa kontrol kung kinsa ang maka-access niini.
Mga palisiya sa pagpagawas sa publiko:
Ang API kay para magamit sa publiko. Ang pagkaanaa sa mga palisiya sa pagpagawas magamit sa publiko. Pananglitan: Microsoft Windows API ug Apple's Cocoa.
Panapos
Ang mga API anaa bisan asa, nag-book ka man og flight o nakig-uban sa mga aplikasyon sa social media. Ang SOAP API gibase sa XML nga mga komunikasyon, lahi kini sa REST API nga wala kini magkinahanglan og bisan unsang espesyal nga configuration.
Ang pagdesinyo sa mga serbisyo sa Rest Web kinahanglan nga mosunod sa pipila ka mga konsepto, lakip ang addressability, statelessness, cacheability, ug usa ka standard interface. Ang mga lagda sa pagpagawas sa API mahimong bahinon sa tulo ka kategorya: mga pribado nga API, mga kauban nga API, ug mga pampublikong API.
Salamat sa pagbasa niini nga artikulo. Tan-awa ang among artikulo sa usa ka Giya sa Seguridad sa API 2022.
