Een REST-API is een API die werkt volgens de REST-architectuur: gegevens worden als 'resources' benaderd via standaard HTTP-verzoeken zoals GET (ophalen), POST (aanmaken), PUT (wijzigen) en DELETE (verwijderen). Het is de meest gebruikte API-stijl voor webapplicaties en SaaS-systemen, met antwoorden meestal in JSON-formaat.
REST-API in de praktijk
De kracht van REST zit in de eenvoud en voorspelbaarheid: elke resource heeft een eigen adres (bijvoorbeeld /orders/1234) en de standaard HTTP-werkwoorden bepalen wat je ermee doet. Daardoor kan vrijwel elke programmeertaal en elk integratieplatform met een REST-API overweg, en is documentatie relatief makkelijk te lezen — ook voor wie geen ontwikkelaar is.
Bij het beoordelen van software loont het om te kijken óf er een REST-API is en hoe volledig die is: kun je alleen lezen, of ook aanmaken en wijzigen? Zit er een limiet op het aantal verzoeken? Die details bepalen wat een koppeling later kan. Hoe zo'n koppeling tot stand komt, lees je in Wat kost een API-koppeling?
Gerelateerde begrippen
- API — Een API (Application Programming Interface) is een gestandaardiseerde manier waarop softwaresystemen gegevens en functies aan elkaar beschikbaar stellen.
- JSON — JSON (JavaScript Object Notation) is het standaard gegevensformaat waarin systemen via API's informatie uitwisselen.
- Webhook — Een webhook is een automatisch bericht dat een systeem direct verstuurt zodra er iets gebeurt — bijvoorbeeld een nieuwe order, een betaalde factuur of een gewijzigde kandidaatstatus.
- OAuth — OAuth is de open standaard waarmee je een applicatie toegang geeft tot je gegevens in een ander systeem, zonder je wachtwoord te delen.