Intro
Mahaigainean edo gailu batean klik gutxi batzuekin, edonoiz erosi, saldu edo argitaratu daiteke edozer gauza. Zehazki nola gertatzen da? Nola informazio hemendik hara joan? Ezagutzen ez den heroia APIa da.
Zer da API bat?
API an esan nahi du APLIKAZIOA PROGRAMATZEKO INTERFAZEA. API batek software osagai bat, bere eragiketak, sarrerak, irteerak eta azpiko motak adierazten ditu. Baina nola azaldu APIa ingeles arruntean? APIak zure eskaera aplikazio batetik transferitzen duen mezulari gisa funtzionatzen du eta erantzuna itzultzen dizu.
Adibidez 1: Linean hegaldiak bilatzen ari zarenean. Aire konpainiaren webgunearekin elkarreragiten duzu. Webguneak data eta ordu jakin horretan eserlekuak eta hegaldiaren kostua zehazten ditu. Zuk aukeratzen duzu zure otordua edo eserlekuak, ekipajea edo maskota eskaerak.
Baina, aire konpainiaren webgune zuzena erabiltzen ari ez bazara edo aire konpainia askoren datuak konbinatzen dituen lineako bidaia-agente bat erabiltzen ari bazara. Informazioa lortzeko, aplikazio batek aire konpainiaren APIarekin elkarreragiten du. Bidaia agentziaren webgunetik aire konpainiaren sistemara datuak eramaten dituen interfazea da APIa.
Aire konpainiaren erantzuna ere hartzen du eta berehala itzultzen du. Horrek bidaia-zerbitzuaren eta aire-konpainiaren sistemen arteko elkarrekintza errazten du hegaldia erreserbatzeko. APIek errutinak, datu-egiturak, objektu-klaseak eta aldagaiak egiteko liburutegi bat dakar. Adibidez, SOAP eta REST zerbitzuak.
Adibidez 2: Best Buy-ek Deal of the Day prezio berezia eskaintzen du bere webgunearen bidez. Datu hauek bere mugikorrerako aplikazioan daude. Aplikazioa ez da barneko prezioen sistemaz kezkatzen; Deal of the Day APIra deitu dezake eta galdetu: zein da prezio berezia? Best Buy-ek eskatutako informazioa erantzuten dio aplikazioak azken erabiltzaileari bistaratzen dion formatu estandarrean.
3. adibidea: Sare sozialetarako APIak funtsezkoak dira. Erabiltzaileek edukia atzi dezakete eta mantentzen dituzten kontu eta pasahitzen kopurua txikia izan dezakete, horrela gauzak erraz izan ditzaten.
- Twitter APIa: Twitterren funtzio gehienekin elkarreragin
- Facebook APIa: ordainketak, erabiltzaileen datuak eta saioa hasteko
- Instagram APIa: etiketatu erabiltzaileak, ikusi modan dauden argazkiak
Zer gertatzen da REST eta SOAP APIekin?
SOAP REST erabili APIa kontsumitzen duen zerbitzu bat, Web API bezala ezagutzen dena. Web zerbitzua ez dago informazioaren aurretiko ezagutzaren menpe. SOAP web-zerbitzuen protokolo bat da, eta plataforma arinetatik independentea da. SOAP XML-en oinarritutako mezularitza-protokolo bat da. SOAP web zerbitzuak ez bezala, Restful zerbitzuak REST arkitektura erabiltzen du, puntuz puntu komunikaziorako eraikia.
SOAP Web zerbitzua
- SOAP Sender - mezu bat sortu eta transmititzea.
- SOAP Receiver - mezua lortu eta prozesatzen du.
- SOAP Intermediary- goiburuko blokeak jasotzen eta prozesatzen ditu.
RESTful Web Zerbitzua
Representational State Transfer (REST) bezeroaren eta zerbitzariaren arteko erlazioarekin eta egoera prozesatzen duen moduari dagokio. Atseden arkitektura, REST zerbitzariak baliabideetarako sarbidea eskaintzen dio bezeroari. Restek baliabideak irakurtzea eta aldatzea edo idaztea kudeatzen ditu. Identifikatzaile Uniformeak (URI) dokumentu bat edukitzeko baliabideak identifikatzen ditu. Horrek baliabideen egoera jasoko du.
REST SOAP arkitektura baino arinagoa da. JSON analizatzen du, gizakiek irakur daitekeen hizkuntza bat, datuak partekatzea eta datuak erabiltzeko errazago ahalbidetzen duena, SOAP arkitekturak erabiltzen duen XML-aren ordez.
Restful Web Service diseinatzeko hainbat printzipio daude, hauek dira:
- Helbideratzea - Baliabide bakoitzak URL bat izan behar du gutxienez.
- Estaturik gabekoa - Restful zerbitzua estaturik gabeko zerbitzua da. Eskaera bat zerbitzuaren iraganeko edozein eskaeratik independentea da. HTTP diseinuz estaturik gabeko protokoloa da.
- Cacheable: sisteman cache daitekeen denda gisa markatutako datuak eta etorkizunean berrerabiltzen dira. Emaitza berdinak eman beharrean eskaera beraren erantzun gisa. Cache-ren murrizketek erantzunen datuak cache daitezkeen edo cachean ez dauden gisa markatzea ahalbidetzen dute.
- Interfaze uniformea - Sarbiderako interfaze arrunt eta estandarizatu bat erabiltzeko aukera ematen du. HTTP metodoen bilduma definitu baten erabilera. Kontzeptu hauek errespetatuz, REST inplementazioa arina da.
REST-en abantailak
- Mezuetarako formatu sinpleagoa erabiltzen du
- Epe luzerako eraginkortasun sendoagoa eskaintzen du
- Estaturik gabeko komunikazioa onartzen du
- Erabili HTTP estandarrak eta gramatika
- Datuak baliabide gisa eskuragarri daude
REST-en desabantailak
- Web zerbitzuaren estandarretan huts egiten du, hala nola, segurtasun-transakzioak eta abar.
- REST eskaerak ez dira eskalagarriak
REST vs SOAP alderaketa
SOAP eta REST web zerbitzuen arteko desberdintasunak.
SOAP Web Zerbitzua | Atseden Web Zerbitzua |
Sarrerako karga handia behar du RESTarekin alderatuta. | REST arina da datu-inprimakietarako URIa erabiltzen baitu. |
SOAP zerbitzuen aldaketak askotan kode aldaketa nabarmena dakar bezeroaren aldetik. | Bezeroaren alboko kodea ez du REST web hornikuntzan zerbitzuen aldaketak eragiten. |
Itzultzeko mota beti XML motakoa da. | Itzulitako datuen formari dagokionez aldakortasuna eskaintzen du. |
XMLn oinarritutako mezuen protokoloa | Protokolo arkitektonikoa |
SOAP liburutegia behar du bezeroaren amaieran. | Ez da liburutegi-laguntzarik behar normalean HTTP bidez erabiltzen. |
WS-Segurtasuna eta SSL onartzen ditu. | SSL eta HTTPS onartzen ditu. |
SOAPek bere segurtasuna definitzen du. | RESTful web-zerbitzuek segurtasun-neurriak oinordetzen dituzte azpiko garraiotik. |
API askatzeko politika motak
APIrako kaleratze-politikak hauek dira:
Kaleratze pribatuko politikak:
APIa enpresa barneko erabilerarako soilik dago erabilgarri.
Bazkideen kaleratze-politikak:
APIa negozio-bazkide jakin batzuentzat bakarrik dago erabilgarri. Enpresek APIaren kalitatea kontrolatu dezakete, nork atzi dezakeen kontrola dela eta.
Askapen publikoko politikak:
APIa erabilera publikorako da. Argitaratze-politiken erabilgarritasuna publikoarentzat eskuragarri dago. Adibidea: Microsoft Windows APIa eta Appleren Cocoa.
Ondorioa
APIak nonahi daude, hegaldi bat erreserbatu edo sare sozialetako aplikazioekin parte hartzen ari zaren ala ez. SOAP API XML komunikazioetan oinarritzen da, REST APIaren desberdina da, ez duelako konfigurazio berezirik behar.
Rest Web zerbitzuak diseinatzeak zenbait kontzepturi atxiki behar die, besteak beste, helbideragarritasuna, aberrigabetasuna, cache-abilitatea eta interfaze estandarra. APIa kaleratzeko arauak hiru kategoriatan bana daitezke: API pribatuak, bazkideen APIak eta API publikoak.
Eskerrik asko artikulu hau irakurtzeagatik. Begiratu gure gida bati buruzko artikulua API segurtasuna 2022.
