Table of Contents[Qari][muuji]
Ma rabtaa inaad ku xidhid app-kaaga Facebook si uu si toos ah ugu soo saaro qoraalo, ama Instagram si aad dib ugu dhejiso sawirada hashtagyada qaarkood?
Waxaad sidoo kale jeclaan kartaa inaad ku darto fiidiyowyada YouTube mareegahaaga. Interface-ka barnaamijka codsiga waxa uu kuu ogolaanayaa inaad qabato dhammaan hawlahan iyo in ka badan (API).
Codsiyada kala duwan ayaa midba midka kale ugu "hadli karaa" si ammaan ah oo habaysan iyadoo ay ugu mahadcelinayaan API-yada sida Instagram API, Facebook API, iyo YouTube API.
Si kale haddii loo dhigo, barnaamijku wuxuu ka qaadan karaa sifooyin ama xogta qayb kale oo software ah oo uu uga faa'iidaysan karo si uu u horumariyo astaamihiisa ama khibradiisa isticmaale. Laakiin sidee apps-ka u samayn karaan codsiyadan, uga baaraandegi karaan, ugana jawaabi karaan qaab ay kuwa kale fahmi karaan?
Taasi waxay ku xidhan tahay sida API-ga loo abuuray. Marka laga hadlayo naqshadaha API (application programming interface), waa caadi in la is barbar dhigo SOAP vs. REST, oo ah laba ka mid ah halbeegyada API ee ugu caansan.
Isla markii ay SOAP API-yada (Protocol-ka Helitaanka Shayga Fudud) ay noqdeen heerka dahabka ee shirkadaha sida Oracle, Sun, iyo PayPal, waxaa jirtay jawaab siman oo ka soo horjeeda sannad ama ka dib xagga REST APIs ee Google, Amazon, iyo eBay.
Maqaalkan, waxaanu is barbardhigi doonaa oo ku barbar dhigi doonaa SOAP API-yada REST APIs si aad u go'aansato midka ugu fiican ujeedooyinkaaga.
Waxaan ku bilaabi doonaa inaan qeexno API-ga.
Waa maxay API?
Interface Programming Interface waxaa loo tixraacaa API. API-yadu asal ahaan waa ururin habab iyo hawlo awood u siinaya horumarinta abka. Waxay helayaan macluumaadka iyo shaqooyinka barnaamijyada kala duwan, adeegyada, ama nidaamyada hawlgalka.
Waxay u adeegaan sidii nooc dhexdhexaadiye ah oo u dhexeeya hababka software ee kala duwan. Waxay awood "hadalka" u dhexeeya laba barnaamij oo aan xidhiidhin.
Aan tusaale u soo qaadano saamilayda si firfircoon uga qayb qaata ganacsiga iyo suuqyada maaliyadeed. Aruurinta iswada algorithms ganacsiga waxaa lagu xidhi karaa goobta dilaaliinta ganacsi ee uu jecelyahay ganacsatadu iyada oo loo marayo API. Tani waxay awood kuu siinaysaa, ganacsadaha, inaad samayso macaamilo elektaroonig ah ama aad aragto xigashooyinka wakhtiga-dhabta ah iyo xogta qiimaha.
Waa maxay nasasho?
Run "adeegyada shabakada" API-yada waxaa ka mid ah REST (Wakiilka Gobolka Wakiil). API-yada REST waxa lagu dhisay URIs (Identifiers Resource Uniform, kaas oo URL uu yahay nooc gaar ah), borotokoolka HTTP, iyo qaabka xogta JSON ee browser-ku habboon ee cajiibka ah.
Hab-maamuuska SOAP, sidaan horeba u sheegnay, waxa laga yaabaa in sidoo kale la isticmaalo. API-yada REST way fududahay in la abuuro oo la koro, laakiin sidoo kale waxay noqon karaan kuwo aad u weyn oo adag-waxay dhammaan ku xiran tahay sida loo abuuray, loo ballaariyay, iyo waxa loogu talagalay inay sameeyaan.
Caqabadaha kheyraadka, shuruudaha amniga oo la dhimay, waafaqid macmiilka browserka, helista, caafimaadka xogta, iyo miisaanka waa qaar ka mid ah sababaha aad u jeclaan lahayd inaad u samayso API-ga si uu u nasto—waxyaabo dhab ahaantii khuseeya adeegyada shabakadda.
REST waxay bixisaa ikhtiyaar miisaan yar oo dheeraad ah. SOAP aad ayay u adkayd in la isticmaalo oo culays ku ah horumariyayaal badan. Tusaale ahaan, isticmaalka SOAP ee JavaScript waxay u baahan tahay qorista kood badan si loo dhammaystiro hawlgallada fudud maadaama qaab-dhismeedka XML ee lagama maarmaanka ah ay tahay in la abuuro mar kasta.
REST (caadi ahaan) waxay adeegsataa URL toosan meeshii codsiga XML. Inkasta oo ay jiraan xaalado naadir ah marka ay tahay inaad bixiso tafaasiil dheeri ah, inta badan adeegyada shabakada RESTful kaliya waxay isticmaalaan farsamada URL.
Afarta xaraf ee HTTP 1.1 GET, POST, PUT, iyo DELETE waxa isticmaali kara REST si ay hawlo u fuliso. Si ka duwan saabuunta, REST uma baahna jawaabta si ay ugu jirto XML.
Adeegyada shabakada REST ku salaysan ee soo saara xogta Command Separated Value (CSV), JavaScript Object Notation (JSON) iyo qaababka Really Simple Syndication (RSS) waa la heli karaa (RSS).
Ujeedadu waa in aad ku heli karto natiijooyinka aad u baahan tahay qaab fudud oo lagu turjumi karo luqadda aad u isticmaalayso codsigaaga.
Features
- REST waxay xooga saaraysaa fududaynta wax kasta oo kale, iyadoo ay ugu wacan tahay borotokoolka HTTP.
- Shabakadda ayaa ugu habboon REST. Way la jaanqaadi kartaa daalacashada sababtoo ah JSON waxa loo isticmaalaa qaabka xogta.
- REST waxay caan ku tahay miisaankeeda iyo xawligeeda.
- Isku xirka macmiilka-serverka iyo qaab-dhismeedyada waxa ka dhigay mid si fudud loo heli karo REST APIs. Haddii ay tahay mid nasasho leh, waxa la dhisay iyada oo la isticmaalayo moodelka macmiilka-server-ka, iyada oo safarro wareeg ah oo u dhexeeya labada dhinac ay gudbinayaan culayska xogta.
- API-yada REST waxay adeegsadaan isdhexgal halbeeg ah oo keligiis ah. Hubinta in dhammaan abka ay ku xidhmaan si isku mid ah oo ay u maraan isla albaab, waxay habaynaysaa sida barnaamijyadu ula xiriiraan API-ga.
Waa maxay SOAP?
Hab-maamuuska u gaarka ah, ee loo yaqaan SOAP (Protocol Helitaanka Shayga Fudud), ayaa ka yara dhib badan REST maadaama uu qeexayo heerar badan, oo ay ku jiraan kuwa la xiriira amniga iyo gaarsiinta farriinta.
Xeerarkan asalka ah waxay la yimaadaan wax yar oo dheeraad ah. Si kastaba ha ahaatee, waxay u noqon karaan qodob go'aamiya ganacsiyada u baahan ammaan aad u ballaaran, wax kala beddelasho, iyo ACID (Atomicity, Consistency, Solation, Adrect) awoodaha u hoggaansanaanta.
Isbarbardhiggan awgeed, waxaa muhiim ah in la ogaado in qaar badan oo ka mid ah faa'iidooyinka SOAP aanay inta badan khusayn codsiyada adeegyada shabakadda, taasoo ka dhigaysa inay ku habboon yihiin xaaladaha nooca ganacsiga ah.
Heerarka sare ee amniga (sida marka a app mobile la macaamilka bangiga), abka fariimaha u baahan isgaarsiin la isku halleyn karo, la falgalka nidaamyada dhaxalka ah, ama u hoggaansanaanta ACID waa dhowr sababood oo aad u jeclaan lahayd inaad naqshadeyso arji adigoo isticmaalaya SOAP API.
Awoodaha fariimaha ee ay bixiso SOAP waxay ku salaysan tahay XML. Tignoolajiyada hore ee interneedka-aan ku haboonayn sida Qaabka Shayga Qaybsan (DCOM) iyo Dallaaliyaha Codsiga Shayga Guud waxa bedelay SOAP markii ugu horaysay ee ay abuurtay Microsoft (CORBA).
Ku-tiirsanaanta isgaarsiinta binary waxay sababtaa nidaamyadan inay fashilmaan. Intarneedka dhexdiisa, fariinta XML ee la midka ah ee ay isticmaasho SOAP ayaa si fiican u shaqeysa.
Features
- Ammaanka SOAP aad ayaa loo adkeeyay. WS-Security waa halbeeg la dhisay oo bixiya SOAP awoodo ammaan oo heer-shirkadeed oo dheeri ah haddii loo baahdo marka lagu daro taageerada SSL.
- Guul/dib u tijaabi sababaynta waxqabadka fariimaha la aamini karo. Sababtoo ah REST waxay ka maqan tahay habka fariinta caadiga ah, waxay dib u tijaabin kartaa kaliya marka isgaarsiintu xumaado. Xitaa marka la isticmaalayo dhexdhexaadiyeyaasha SOAP, SOAP waxay bixisaa ku-tiirsanaanta dhamaadka-ilaa-dhamaadka sababtoo ah ku-dhisantay guul/dib-u-isku-dayid macquul ah.
- SOAP waxay mar hore u hoggaansantay heerarka ACID. Adiga oo tilmaamaya sida macaamiladu ula falgali karaan xogta, u hogaansanaanta ACID waxay yaraynaysaa cilladaha waxayna ilaalisaa joogtaynta xogta xogta. Sababtoo ah ACID aad ayey uga taxadar badan tahay moodooyinka kale ee joogtaynta xogta, waxaa si joogta ah loo isticmaalaa marka la maaraynayo wax kala iibsiga xasaasiga ah, ha ahaato mid dhaqaale ama si kale.
- Way u fududahay barmaamijyada inay fahmaan maadaama SOAP ay tahay wada xidhiidh XML ku salaysan.
- Hab-maamuuska fariimaha XML waa ku kordhinta borotokoolka HTTP.
- Isgaadhsiinta kombuyuutar ilaa kombuyuutar kale ayaa lagu faafin karaa fariinta SOAP.
- Qaab dhismeedka macmiilka-server sidoo kale waa la hirgelin karaa. Farriinta borotokoolka SOAP waxaa isticmaali kara macmiilku si uu ugu waco wicitaanka habraaca fog ee ku yaal dhinaca server-ka.
Nasashada Vs Farqiga Saabuunta
1. Dhismaha
API waxa loogu talagalay in uu ugu horrayn muujiyo qaybo gaar ah oo ka mid ah macquulnimada ganacsi ee codsiga serverka. Iyadoo REST ay u isticmaasho URI isla ujeedo la mid ah, SOAP waxay u shaqeysaa Interface-ka Adeegga.
API-yada REST waxa la abuuraa xogta ka dib, halka API-yada SOAP-yada la sameeyay ka dib shaqooyinka API-ku muujiyo. Marka la barbar dhigo SOAP, taas oo hawl badan wadata, REST waa nakhshad xog badan wadata.
2. Waxbarista
Xogta lagu calaamadeeyay inay tahay mid la kaydin karo ayaa mar kale isticmaali kara browser-yada iyaga oo aan uga baahnayn inay codsi cusub u diraan server-ka. Badbaadinta wakhtiga iyo dadaalka ayaa faa'iido u leh tan.
Jawaabaha laguma kaydin doono heerka HTTP maadaama su'aalaha SOAP lagu soo gudbiyo codsiyada POST, kaas oo heerka HTTP u arko mid aan awood lahayn. Haddii aad rabto inaad shaqaaleysiiso kaydinta, waa inaad weli dhistaa farsamooyinka lagama maarmaanka ah maadaama REST API-yada aysan ku jirin hirgelintan.
3. Khayraadka & Xadka xad dhaafka ah
Xawaaladaha lacag bixinta ee qaabka baqshadda ee ay adeegsato SOAP awgeed, waxaa jira koror dhexdhexaad ah oo dusha sare ah, kaas oo u baahan xawilaad dheeri ah. Dabeecada fudud ee REST waa faa'iido xaaladahan sababtoo ah waxaa guud ahaan loo adeegsadaa adeegyada shabakada.
4. Ammaanka
WS-security, oo ay SOAP taageerto oo inyar ka faahfaahsan SSL heerka gaadiidka, waa mid la jecel yahay. Ku darista tillaabooyinka amniga ee heerka ganacsiga sidoo kale waa ku habboon yahay.
Dhammaadka-ilaa-dhamaadka sirta iyadoo la adeegsanayo SSL waxaa taageera saabuunta iyo REST labadaba, REST-na waxay isticmaali kartaa HTTPS, kala duwanaanshaha aaminka ah ee borotokoolka HTTP.
5. Wax ka qabashada culeysyada mushaarka
Xogta lagu kala qaado intarneedka waxa loo tixraacaa culays-saar. Culayska loo arko "culus" wuxuu u baahan yahay ilo dheeraad ah. Marka la barbardhigo SOAP, taas oo adeegsata XML, REST waxay inta badan isticmaashaa JSON iyo HTTP si ay uga caawiso dhimista culeyska.
Maktabad khaas ah oo macmiil ah oo leh kood la soo saaray waa in caadi ahaan macmiilku isticmaalo si uu u galo SOAP API-yada sababtoo ah qandaraaskooda isgaadhsiinta ee aadka u adag.
Natiijadu waxay tahay, SOAP waxay bixisaa heer ka hooseeya oo la taaban karo marka loo eego REST waxayna aad ugu dhowdahay server-ka.
Goorma la isticmaalayo REST?
- Abuuritaanka API-yada dadweynaha: API-yada REST ayaa loo door bidayaa dhisidda adeegyada shabakadda dadweynaha sababtoo ah waxaa loo arkay inay ka fudud yihiin isticmaalka iyo qaadashada marka loo eego SOAP APIs. Intaa waxaa dheer, SOAP waxay bixisaa dhowr tilaabo oo amniga lagu dhex dhisay oo aysan REST lahayn, in kasta oo sifooyinkan aan loo baahnayn marka lagu shaqaynayo xogta iyo adeegyada furan.
- Dhisidda apps mobile: REST waxay ku fiican tahay in la dhiso codsiyada mobaylada maadaama ay yar tahay, wax ku ool tahay, aan waddan lahayn, oo la kaydsan karo.
- Ka faa'iidaysiga agabka server-ka oo aad u yar iyo bandwidthDhammaan codsiyada REST API waa inay ahaadaan kuwo aan waddan lahayn, taas oo macnaheedu yahay in isdhexgalka kastaa uu gooni yahay oo codsi kasta iyo jawaab kasta ayaa ka kooban dhammaan xogta lagama maarmaanka u ah dhamaystirka isdhexgalkaas. Seerfarku ma kaydiyo diiwaanada codsiyadii hore maadaama uu mid walba ula dhaqmo codsi cusub. Natiijo ahaan, server-ku wuxuu u baahan yahay xasuus aad u yar wuxuuna u shaqeeyaa si dhakhso ah sababtoo ah codsigu uma baahna ficil dheeraad ah ama soo celinta xogta taariikhiga ah.
Goorma ayaa la isticmaalayaa SOAP?
- Abuuritaanka API-yo gaar ah, gaar ahaan ganacsiyada waaweyn: SOAP waxay ku fiican tahay codsiyada shirkadaha maadaama ay awood u siiso socodka xogta ee deegaan baahsan, qaybsan oo ka kooban dhowr astaamood oo amniga khadka ah.
- Isticmaalka borotokoolka gaadiidka aan HTTP ahayn lakabka hoose: SOAP kuma xirna HTTP sida lakabka hoose. Iyada oo ku xidhan codsigaaga, waxaad isticmaali kartaa SMTP (Bartakoolka Wareejinta Boostada ee Fudud), JMS (Adeegga Farriimaha Java), ama borotokoolka gaadiidka kale.
- Ku shaqeynta hawlgallo qeexan: Si ka duwan codsiyada REST APIs, codsiyada SOAP API-yada waa kuwo sharci ah, taasoo la macno ah adeeguhu wuxuu kaydiyaa macluumaadka macmiilka oo uu uga faa'iidaysto silsilado codsiyo ama hawlgallo ah. Xataa iyadoo ay tani isticmaalayso xawilaad badan oo adeege iyo ilo, waxay muhiim u tahay fulinta hawlaha joogtada ah ama kuwa xidhiidhka la leh, sida xawilaadaha bangiga.
Ugu Dambeyn
Isbarbardhigga u dhexeeya REST iyo SOAP APIs ayaa si cad u caddaynaya in REST ay ka door bidayso SAABUUNKA. Xitaa weli, waxaa jira xaalado halkaas oo SOAP API looga baahan yahay. Xaaladaha qaarkood, adeegyada shabakadda waxaa la abuuraa iyadoo la isku darayo REST iyo API-yada SOAP.
Sidaa darteed, kiiska isticmaalka ayaa go'aamin doona qaabka API ee u shaqeyn doona sida ugu fiican.
Leave a Reply