Een REST API is een API die werkt volgens de stijl REST (Representational State Transfer). Systemen wisselen gegevens uit via gewone webadressen en de standaardopdrachten van HTTP, waarbij elke aanvraag op zichzelf staat.
Hoe een REST API werkt
In een REST API heeft elk onderdeel, een resource, een eigen adres. Een product heeft bijvoorbeeld een adres dat eindigt op het woord producten en het nummer van dat product. Met de HTTP-methoden geef je aan wat je ermee wilt doen:
- GET: gegevens opvragen
- POST: nieuwe gegevens aanmaken
- PUT of PATCH: gegevens wijzigen
- DELETE: gegevens verwijderen
Het antwoord is meestal in het formaat JSON.
Belangrijkste kenmerken
Een kenmerk van REST is dat de server geen gegevens over eerdere aanvragen bewaart. Elke aanvraag bevat alle informatie die nodig is om haar te beantwoorden. Daarnaast zijn client en server van elkaar gescheiden: een app, een website of een ander systeem kan dezelfde REST API gebruiken, zolang het zich aan de afspraken houdt.
Gebruik en nuances
REST API’s worden veel gebruikt om een app of website te laten samenwerken met een webshop of ander systeem. REST is een ontwerpstijl en geen strikte norm, dus de uitwerking verschilt per aanbieder. Het is daarom belangrijk de documentatie van de betreffende API te lezen. Er bestaan ook andere manieren om een API op te zetten, zoals GraphQL.
Een REST API in de praktijk
Een winkelketen heeft een webshop en een eigen app. Beide halen de productgegevens op uit dezelfde REST API. Het assortiment hoeft daardoor maar op één plek beheerd te worden. Wanneer er een nieuw product bij komt, verschijnt het in de webshop en in de app. Dit is een illustratief voorbeeld van waarom het scheiden van gegevens en weergave nuttig kan zijn.
