Intro
Dhawr gujin oo ku yaal miiska ama aaladda, qofku wuu iibsan karaa, iibin karaa ama daabici karaa shay, wakhti kasta. Dhab ahaan sidee u dhacdaa? Sidee u sameeyaa macluumaad ka soo qaad halkan ilaa halkaas? Halyeyga aan la aqoonsan waa API.
Waa maxay API?
API waxay u taagan tahay an BARASHADA ARJIGA. API waxa ay muujisaa qayb software ah, hawlaheeda, wax-soo-saarka, iyo noocyada hoose. Laakin sideed ugu sharaxdaa API-ga Ingiriisi cad? API-gu waxa uu u shaqeeyaa sidii fariin ka gudbisa codsigaaga codsiga oo ku soo celisa jawaabta adiga.
Tusaale 1: Markaad duullimaadyada ka raadinayso onlayn. Waxaad la falgashaa mareegaha diyaaradda. Websaydhku wuxuu faahfaahinayaa fadhiga iyo kharashka duulimaadka taariikhda iyo wakhtigaas gaarka ah. Waxaad dooranaysaa cuntadaada ama fadhigaaga, boorsadaada, ama codsiyada xayawaankaaga.
Laakin, haddii aadan isticmaalin website-ka tooska ah ee diyaaradda ama aad isticmaalayso wakiil socdaal oo khadka ah kaas oo isku dara xogta shirkado badan oo diyaaradeed. Si loo helo macluumaadka, codsigu wuxuu la falgalaa API-ga diyaaradda. API-ku waa isku-xidhka xogta ka qaadata degelka wakiilka socdaalka una gudbisa nidaamka diyaaradda.
Waxa kale oo ay qaadataa jawaabta diyaaradda oo ay isla markiiba soo celisaa. Tani waxay fududaynaysaa isdhexgalka ka dhexeeya adeegga safarka, iyo nidaamka diyaaradda - si loo ballansado duulimaadka. API's waxay ka kooban tahay maktabad loogu talagalay hab-socodka, qaab-dhismeedka xogta, fasallada shayga, iyo doorsoomayaasha. Tusaale ahaan, adeegyada SOAP iyo REST.
Tusaale 2: Best Buy waxay ka dhigtaa Deal of the Day qiimaynta mid gaar ah oo laga heli karo shabakadeeda. Xogtan oo kale ayaa ku jirta codsigeeda moobiilka. Appku kama welwelo nidaamka qiimaha gudaha - waxay wici kartaa Deal of the Day API oo wayddiin kartaa, waa maxay qiimaha gaarka ah? Best Buy waxay kaga jawaabtaa macluumaadka la codsaday qaab caadi ah oo uu appku u soo bandhigo isticmaalaha ugu dambeeya.
Tusaale 3: API-yada loogu talagalay warbaahinta bulshada waa muhiim. Isticmaalayaashu waxay heli karaan macluumaadka oo waxay hayn karaan tirada xisaabaadka iyo furayaasha sirta ah ee ay la socdaan hoose, si ay u fududeeyaan waxyaallaha.
- Twitter API: La falgeli inta badan hawlaha Twitter
- Facebook API: Lacag-bixinta, xogta isticmaalaha, iyo gelitaanka
- Instagram API: Tag isticmaalayaasha, arag sawirada isbedelaya
Ka waran REST & SOAP API's?
SAABUUN iyo REST adeegso adeega API-cunaya, oo loo yaqaan Web API. Adeegga mareegaha kuma xidhna aqoonta hore ee macluumaadka. SOAP waa hab-maamuuska adeegga mareegaha oo miisaankiisu fudud yahay oo madaxbannaan. SOAP waa hab-maamuuska fariimaha ku salaysan XML. Si ka duwan adeegga shabakadda SOAP, adeegga nasashada wuxuu adeegsadaa naqshadda REST, oo loo dhisay isgaarsiin-dhibic-ilaa.
Adeegga Shabakadda SOAP
- Soo diraha SOAP - abuurista iyo gudbinta fariin.
- Qaataha SOAP- wuxuu helaa oo socodsiiyaa fariinta.
- Dhexdhexaadiyaha SOAP- wuxuu qaataa oo farsameeyaa blocksyada madaxa.
Adeegga Shabakadda ee RESTful
Wareejinta Gobolka (REST) oo matalaysa waxay la xidhiidhaa xidhiidhka u dhexeeya macmiilka iyo serverka iyo sida uu gobolku u shaqeeyo. Nasasho nasasho naqshadeeye, Server-ka REST ayaa siiya marin u helka kheyraadka macmiilka. Nasashada waxay gacanta ku haysaa akhrinta iyo wax ka beddelka ama qorista agabka. Aqoonsiga lebbiska (URI) wuxuu aqoonsadaa agabka uu ku jiro dukumeenti. Tani waxay qabsan doontaa gobolka kheyraadka.
Nasashada way ka fudud tahay dhismaha SOAP Waxay kala saartaa JSON, luuqad bini'aadmigu akhrin karo oo awood u siinaya wadaaga xogta oo si sahlan loo isticmaalo xogta, halkii XML ay isticmaali lahayd naqshadaha SOAP.
Waxaa jira dhowr mabaadi'da qaabeynta Adeegga Shabakadda Nasashada, kuwaas oo kala ah:
- Ciwaanka - Ilaha kasta waa inuu lahaadaa ugu yaraan hal URL.
- Dawlad la'aan - Adeeg nasasho leh waa adeeg bilaa waddan ah. Codsigu waa ka madax bannaan yahay codsiyadii hore ee adeeggu. HTTP waa qaabaynta borotokool aan wadan.
- La kaydin karo - Xogta loo calaamadeeyay inay tahay bakhaar la kaydin karo nidaamka oo dib loo isticmaalo mustaqbalka. Sida jawaabta codsi isku mid ah halkii laga soo saari lahaa natiijooyin isku mid ah. Caqabadaha kaydinta ayaa awood u siinaya xogta jawaabta in lagu calaamadiyo mid la kaydsan karo ama aan la kaydsan karin.
- Interface-ka lebbisan - Waxay ogolaataa is-dhexgal caadi ah oo la jaanqaadaya si loo isticmaalo gelitaanka. Isticmaalka ururinta qeexan ee hababka HTTP. U hoggaansanaanta fikradahan waxay hubinaysaa, hirgelinta REST waa mid fudud.
Faa'iidooyinka REST
- Waxay u isticmaashaa qaab ka fudud fariimaha
- Waxay bixisaa hawlkarnimo dheer oo xooggan
- Waxay taageertaa isgaadhsiinta bilaa dawlad ah
- Isticmaal heerarka HTTP iyo naxwaha
- Xogta waxaa loo heli karaa ilo ahaan
Faa'iido darrada REST
- Ku guul daraystay heerarka adeegga Mareegta sida Ganacsiga Amniga iwm.
- Codsiyada REST maaha kuwo la qiyaasi karo
Nasashada vs Isbarbardhigga Saabuunta
Farqiga u dhexeeya SOAP iyo REST adeegyada shabakada
Adeegga Shabakadda SOAP | Adeegga Shabakadda Nasashada |
Waxay u baahan tahay galinta culus marka la barbar dhigo REST. | REST waa mid fudud maadaama ay URI u isticmaasho foomamka xogta. |
Isbeddelka adeegyada SOAP inta badan wuxuu keenaa isbeddel weyn oo koodka dhinaca macmiilka. | Koodhka dhinaca macmiilka ma saameeyo isbeddelka adeegyada ku jira bixinta shabakadda REST. |
Nooca soo noqoshada had iyo jeer waa nooca XML. | Waxay bixisaa kala duwanaansho marka la eego qaabka xogta la soo celiyay. |
Hab-maamuuska fariinta ku salaysan XML | Hab-maamuuska dhismaha |
Wuxuu u baahan yahay maktabad SOAP ah oo ku taal dhammaadka macmiilka. | Looma baahna taageerada maktabadda sida caadiga ah HTTP. |
Waxay taageertaa WS-Security iyo SSL. | Waxay taageertaa SSL iyo HTTPS. |
SOAP waxay qeexdaa ammaankeeda. | Adeegyada shabakada ee nasashada waxay ka dhaxlaan tallaabooyinka amniga gaadiidka hoose. |
Noocyada Xeerarka Siideynta API
Xeerarka siideynta API waa:
Siyaasadaha sii daynta gaarka ah:
API-ga waxa kaliya oo loo heli karaa isticmaalka shirkadda gudaha.
Xeerarka sii deynta shuraakada:
API-ga waxa kaliya oo loogu talagalay la-hawlgalayaasha ganacsi ee gaarka ah. Shirkaduhu waxay xakameyn karaan tayada API sababtoo ah xakamaynta cidda geli karta.
Siyaasadaha sii daynta dadweynaha:
API-ga waxaa loogu talagalay isticmaalka dadweynaha Helitaanka siyaasadaha sii deynta ayaa diyaar u ah dadweynaha. Tusaale: Microsoft Windows API iyo Apple's Cocoa.
Ugu Dambeyn
API-yadu meel walba way joogaan, haddii aad ballansanayso duulimaad ama aad ku hawlan tahay codsiyada warbaahinta bulshada. SOAP API waxay ku salaysan tahay isgaadhsiinta XML, way kaga duwan tahay REST API in aanay u baahnayn qaabayn gaar ah.
Nashqadaynta adeegyada Shabakadda Nasashada waa in ay u hoggaansamaan fikrado gaar ah, oo ay ku jiraan cinwaan la'aanta, waddan la'aanta, kaydinta, iyo is-dhexgalka caadiga ah. Xeerarka siidaynta API waxa loo qaybin karaa saddex qaybood: API-yada gaarka ah, API-yada lammaanaha, iyo API-yada dadweynaha.
Waad ku mahadsan tahay akhrinta maqaalkan. Fiiri maqaalkeena ku saabsan Hagaha Amniga API 2022.
