Intro
Met een paar klikken op een desktop of apparaat kan men op elk moment alles kopen, verkopen of publiceren. Hoe gebeurt het precies? Hoe doet informatie van hier naar daar komen? De onbekende held is de API.
Wat is een API?
API staat voor een APPLICATIE-PROGRAMMEERINTERFACE. Een API drukt een softwarecomponent uit, zijn bewerkingen, invoer, uitvoer en onderliggende typen. Maar hoe leg je de API in gewoon Engels uit? De API functioneert als een boodschapper die uw verzoek van een applicatie overbrengt en het antwoord aan u terugbezorgt.
Voorbeeld 1: Wanneer u online naar vluchten zoekt. U communiceert met de website van de luchtvaartmaatschappij. De website geeft informatie over de zitplaatsen en de kosten van de vlucht op die specifieke datum en tijd. U kiest uw maaltijd- of zitplaats-, bagage- of huisdierverzoeken.
Maar als u niet de directe website van de luchtvaartmaatschappij gebruikt of een online reisbureau gebruikt dat gegevens van veel luchtvaartmaatschappijen combineert. Om de informatie te krijgen, communiceert een applicatie met de API van de luchtvaartmaatschappij. De API is de interface die gegevens van de website van de reisagent naar het systeem van de luchtvaartmaatschappij brengt.
Het neemt ook de reactie van de luchtvaartmaatschappij en levert het direct terug. Dit vergemakkelijkt de interactie tussen de reisservice en de systemen van de luchtvaartmaatschappij om de vlucht te boeken. API's omvatten een bibliotheek voor routines, datastructuren, objectklassen en variabelen. Bijvoorbeeld SOAP- en REST-services.
Voorbeeld 2: Best Buy maakt een speciale Deal van de dag-prijs beschikbaar via haar website. Deze zelfde gegevens staan in de mobiele applicatie. De app maakt zich geen zorgen over het interne prijssysteem - hij kan de Deal of the Day API bellen en vragen: wat is de speciale prijsstelling? Best Buy reageert met de gevraagde informatie in een standaardformaat dat de app weergeeft aan de eindgebruiker.
Example3: API's voor sociale media zijn cruciaal. Gebruikers hebben toegang tot inhoud en houden het aantal accounts en wachtwoorden dat ze bijhouden laag, zodat ze het simpel kunnen houden.
- Twitter API: interactie met de meeste Twitter-functies
- Facebook API: voor betalingen, gebruikersgegevens en inloggen
- Instagram API: tag gebruikers, bekijk trending foto's
Hoe zit het met REST & SOAP API's?
SOAP en REST gebruik een API-consumerende service, bekend als Web API. Webservice is niet afhankelijk van enige voorkennis van informatie. SOAP is een webserviceprotocol dat lichtgewicht platformonafhankelijk is. SOAP is een op XML gebaseerd berichtenprotocol. In tegenstelling tot SOAP-webservices, maakt Restful-service gebruik van REST-architectuur, gebouwd voor point-to-point-communicatie.
SOAP-webservice
- SOAP Sender – een bericht maken en verzenden.
- SOAP-ontvanger – verkrijgt en verwerkt het bericht.
- SOAP-intermediair: ontvangt en verwerkt headerblokken.
RESTful-webservice
Representational State Transfer (REST) heeft betrekking op de relatie tussen de client en de server en hoe de status wordt verwerkt. Rest-architectuur, een REST-server biedt toegang tot bronnen aan de client. Rest zorgt voor het lezen en wijzigen of schrijven van de bronnen. Uniform Identifier (URI) identificeert bronnen om een document te bevatten. Hiermee wordt de resourcestatus vastgelegd.
REST is lichter dan SOAP-architectuur. Het ontleedt JSON, een door mensen leesbare taal die het delen van gegevens en gemakkelijker te gebruiken gegevens mogelijk maakt, in plaats van XML die wordt gebruikt door de SOAP-architectuur.
Er zijn verschillende principes voor het ontwerpen van Restful Web Service, namelijk:
- Adresseerbaarheid - Elke bron moet ten minste één URL hebben.
- Staatloosheid – Een rustgevende dienst is een staatloze dienst. Een verzoek is onafhankelijk van eerdere verzoeken door de service. HTTP is van nature een staatloos protocol.
- Cachebaar - Gegevens die zijn gemarkeerd als cachebaar, worden in het systeem opgeslagen en in de toekomst hergebruikt. Als het antwoord op hetzelfde verzoek in plaats van dezelfde resultaten te produceren. Cachebeperkingen maken het mogelijk om responsgegevens te markeren als cachebaar of niet-cachebaar.
- Uniforme interface – Maakt het mogelijk een gemeenschappelijke en gestandaardiseerde interface te gebruiken voor toegang. Het gebruik van een gedefinieerde verzameling HTTP-methoden. Als u zich aan deze concepten houdt, is de REST-implementatie licht van gewicht.
Voordelen van RUST
- Gebruikt eenvoudiger formaat voor berichten
- Biedt sterkere efficiëntie op lange termijn
- Het ondersteunt staatloze communicatie
- Gebruik HTTP-standaarden en grammatica
- Gegevens zijn beschikbaar als bron
Nadelen van REST
- Mislukt in standaarden van webservices zoals beveiligingstransacties enz.
- REST-aanvragen zijn niet schaalbaar
REST versus SOAP-vergelijking
Verschillen tussen SOAP- en REST-webservices.
SOAP-webservice | Rest webservice |
Vereist een zware invoerlading in vergelijking met REST. | REST is lichtgewicht omdat het URI gebruikt voor gegevensformulieren. |
Wijzigingen in SOAP-services leiden vaak tot een aanzienlijke wijziging in de code aan de kant van de klant. | Code aan clientzijde wordt niet beïnvloed door wijzigingen in services in REST-webprovisioning. |
Retourtype is altijd XML-type. | Biedt veelzijdigheid met betrekking tot de vorm van de geretourneerde gegevens. |
Een op XML gebaseerd berichtenprotocol | Een architectonisch protocol |
Vereist een SOAP-bibliotheek aan het einde van de client. | Geen bibliotheekondersteuning nodig, meestal gebruikt via HTTP. |
Ondersteunt WS-beveiliging en SSL. | Ondersteunt SSL en HTTPS. |
SOAP definieert zijn eigen beveiliging. | RESTful webservices nemen beveiligingsmaatregelen over van het onderliggende transport. |
Soorten API-vrijgavebeleid
Releasebeleid voor API is:
Beleid voor privé vrijgeven:
De API is alleen beschikbaar voor intern bedrijfsgebruik.
Vrijgavebeleid voor partners:
De API is alleen beschikbaar voor bepaalde zakenpartners. De bedrijven kunnen de kwaliteit van de API controleren vanwege de controle over wie er toegang toe heeft.
Beleid voor openbare vrijgave:
De API is voor openbaar gebruik. Beschikbaarheid van het releasebeleid is beschikbaar voor het publiek. Voorbeeld: Microsoft Windows API en Apple's Cocoa.
Conclusie
API's zijn overal aanwezig, of u nu een vlucht boekt of bezig bent met sociale media-applicaties. SOAP API is gebaseerd op XML-communicatie en verschilt van REST API doordat er geen speciale configuratie voor nodig is.
Het ontwerpen van Rest-webservices moet zich houden aan bepaalde concepten, waaronder adresseerbaarheid, staatloosheid, cachebaarheid en een standaardinterface. API-releaseregels kunnen worden onderverdeeld in drie categorieën: privé-API's, partner-API's en openbare API's.
Bedankt voor het lezen van dit artikel. Bekijk ons artikel over een gids voor API-beveiliging 2022.
