Intro
Mat e puer Klick op engem Desktop oder Apparat kann een alles kafen, verkafen oder publizéieren, egal wéini. Wéi genee geschitt et? Wéi mécht Informatiounen vun hei bis dohinner kommen? Den net unerkannten Held ass d'API.
Wat ass eng API?
API steet fir eng APPLIKATIOUN PROGRAMMERING INTERFACE. Eng API dréckt e Softwarekomponent aus, seng Operatiounen, Inputen, Ausgänge an ënnerierdesch Aarte. Awer wéi erkläert Dir d'API op Einfach Englesch? D'API funktionéiert als Messenger, deen Är Ufro vun enger Applikatioun transferéiert an d'Äntwert op Iech zréck liwwert.
Beispill 1: Wann Dir no Flich online sicht. Dir interagéiert mat der Websäit vun der Fluchgesellschaft. D'Websäit detailléiert de Sëtz an d'Käschte vum Fluch op deem bestëmmten Datum an Zäit. Dir wielt Är Iessen oder Sëtzplazen, Gepäck oder Hausdéieren Ufroen.
Awer wann Dir net déi direkt Websäit vun der Fluchgesellschaft benotzt oder en Online Reesagent benotzt deen Daten vu ville Fluchgesellschaften kombinéiert. Fir d'Informatioun ze kréien, interagéiert eng Applikatioun mat der API vun der Airline. D'API ass d'Interface déi Daten vun der Websäit vum Reesagent an de System vun der Fluchgesellschaft hëlt.
Et hëlt och d'Äntwert vun der Airline a liwwert direkt zréck. Dëst erliichtert d'Interaktioun tëscht dem Reesdéngscht an de Systemer vun der Fluchgesellschaft - fir de Fluch ze buchen. API's enthalen eng Bibliothéik fir Routinen, Datestrukturen, Objektklassen a Variablen. Zum Beispill SOAP a REST Servicer.
Beispill 2: Best Buy mécht en Deal vum Dag Präisser speziell iwwer seng Websäit verfügbar. Déiselwecht Donnéeën sinn a senger mobiler Applikatioun. D'App mécht sech keng Suergen iwwer den internen Präissystem - et kann den Deal of the Day API ruffen a froen, wat ass d'Präisser speziell? Best Buy reagéiert mat der ugefrote Informatioun an engem Standardformat deen d'App dem Endverbraucher weist.
Beispill 3: APIs fir sozial Medien sinn entscheedend. D'Benotzer kënnen Zougang zum Inhalt kréien an d'Zuel vu Konten a Passwierder halen, déi se verfollegen, sou datt se d'Saachen einfach behalen.
- Twitter API: Interagéiert mat de meeschte Twitter Funktiounen
- Facebook API: Fir Bezuelungen, Benotzerdaten a Login
- Instagram API: Tag Benotzer, kuckt trending Fotoen
Wat iwwer REST & SOAP APIen?
Seef an Rescht benotzt en API-konsuméierende Service, bekannt als Web API. Web Service ass net ofhängeg vun all Viraus Wëssen vun Informatiounen. SOAP ass e Webserviceprotokoll dee liicht Plattform-onofhängeg ass. SOAP ass en XML-baséiert Messagerie Protokoll. Am Géigesaz zu SOAP Webservice benotzt Restful Service REST Architektur, gebaut fir Punkt-zu-Punkt Kommunikatioun.
SOAP Web Service
- SOAP Sender - e Message erstellen an iwwerdroen.
- SOAP Receiver - kritt a veraarbecht de Message.
- SOAP Intermédiair- kritt a veraarbecht Headerblocken.
RESTful Web Service
Representational State Transfer (REST) bezitt sech op d'Relatioun tëscht dem Client an dem Server a wéi de Staat veraarbecht. Rescht Architektur, e REST Server bitt Ressource Zougang zum Client. Rescht geréiert d'Liesen an d'Ännerung oder d'Schreiwe vun de Ressourcen. Uniform Identifier (URI) identifizéiert Ressourcen fir en Dokument ze enthalen. Dëst wäert de Ressourcezoustand erfaassen.
REST ass méi hell wéi SOAP Architektur. Et parséiert JSON, eng mënschlech liesbar Sprooch déi d'Datenaustausch erméiglecht a méi einfach Daten ze benotzen, anstatt XML vun der SOAP Architektur benotzt.
Et gi verschidde Prinzipien fir de Restful Web Service ze designen, déi sinn:
- Adressbarkeet - All Ressource soll op d'mannst eng URL hunn.
- Statelessness - E rouege Service ass e stateless Service. Eng Ufro ass onofhängeg vun all fréier Ufroe vum Service. HTTP ass vum Design e stateless Protokoll.
- Cacheable - Daten markéiert als cacheable Geschäfter am System a weiderbenotzen an Zukunft. Als Äntwert op déiselwecht Ufro amplaz déiselwecht Resultater ze produzéieren. Cache Aschränkungen erméiglechen d'Äntwertdatenmarkéierung als cachebar oder net cachebar.
- Uniform Interface - Erlaabt eng gemeinsam a standardiséierter Interface fir Zougang ze benotzen. D'Benotzung vun enger definéierter Sammlung vun HTTP-Methoden. Bleift un dës Konzepter garantéiert, REST Implementatioun ass liicht.
Virdeeler vun REST
- Benotzt méi einfach Format fir Messagen
- Bitt méi staark laangfristeg Effizienz
- Et ënnerstëtzt stateless Kommunikatioun
- Benotzt HTTP Normen a Grammatik
- Daten sinn als Ressource verfügbar
Nodeeler vun REST
- Feeler an Normen vum Webservice wéi Sécherheetstransaktiounen etc.
- REST Ufroe sinn net skalierbar
REST vs SOAP Verglach
Differenzen tëscht SOAP a REST Webservicer.
SOAP Web Service | Rescht Web Service |
Erfuerdert schwéier Input Notzlaascht am Verglach zum REST. | REST ass liicht well et URI fir Dateformen benotzt. |
D'Ännerung vun de SOAP-Servicer féiert dacks zu enger wesentlecher Ännerung vum Code op der Client Säit. | Client-Säit Code ass net beaflosst vun der Ännerung vun de Servicer an der REST Web Dispositioun. |
Retour Typ ass ëmmer XML Typ. | Bitt Villsäitegkeet mat Respekt un der Form vun der zréckginn Donnéeën. |
En XML-baséiert Message Protokoll | En architektonescht Protokoll |
Verlaangt eng SOAP Bibliothéik um Enn vum Client. | Keng Bibliothéik Ënnerstëtzung néideg typesch iwwer HTTP benotzt. |
Ënnerstëtzt WS-Security an SSL. | Ënnerstëtzt SSL an HTTPS. |
SOAP definéiert seng eege Sécherheet. | RESTful Webservicer ierwen Sécherheetsmoossname vum ënnerierdesche Transport. |
Aarte vun API Fräisetzung Politiken
Verëffentlechungspolitike fir API sinn:
Privat Verëffentlechungspolitik:
D'API ass nëmme fir intern Firma benotzt.
Partner Verëffentlechungspolitik:
D'API ass nëmme fir speziell Geschäftspartner verfügbar. D'Firmen kënnen d'Qualitéit vun der API kontrolléieren wéinst der Kontroll iwwer wien et zougitt.
Ëffentlech Verëffentlechungspolitik:
D'API ass fir ëffentlech Notzung. Disponibilitéit vun der Verëffentlechungspolitik ass fir de Public verfügbar. Beispill: Microsoft Windows API an Apple's Cocoa.
Konklusioun
APIs sinn iwwerall präsent, egal ob Dir e Fluch bucht oder mat sozialen Medien Uwendungen engagéiert. SOAP API baséiert op XML Kommunikatiounen, et ënnerscheet sech vun REST API an datt et keng speziell Konfiguratioun erfuerdert.
Design Rest Web Servicer sollten u bestëmmte Konzepter halen, dorënner Adressbarkeet, Staatlosegkeet, Cachebarkeet an eng Standard Interface. API Verëffentlechungsregele kënnen an dräi Kategorien opgedeelt ginn: privat APIen, Partner APIen an ëffentlech APIen.
Merci fir d'Liesen vun dësem Artikel. Kuckt eisen Artikel iwwer e Guide fir API Sécherheet 2022.
