Wat is een REST API?

REST API is een architecturale stijl, geen standaard, voor het bouwen van gedistribueerde systemen. Het is gebaseerd op principes zoals statelessness, client-server architectuur en het gebruik van standaard HTTP-methoden (GET, POST, PUT, DELETE, PATCH) voor operaties op resources.

Belangrijke principes van REST:

• Stateless (zonder toestand): De server bewaart geen informatie over de toestand van de client tussen verzoeken. Elk verzoek bevat alle benodigde informatie voor verwerking.
• Client-Server: Duidelijke scheiding tussen client en server. Elk kan onafhankelijk evolueren.
• Cacheable: Antwoorden kunnen gemarkeerd worden als cachebaar of niet, wat de prestaties verbetert.
• Gelaagd systeem: De client weet niet of hij direct verbonden is met de server of via tussenlagen.
• Uniforme interface: Gestandaardiseerde manieren om met resources te communiceren. Dit omvat:
  • Identificatie van resources (URI)
  • Manipulatie van resources via representaties
  • Zelfbeschrijvende berichten
  • Hypermedia als de motor van de applicatiestatus (HATEOAS) - de status van de applicatie wordt beheerd via hyperlinks.

Voorbeeld van het gebruik van standaard HTTP-methoden:

HTTP-methode	Actie op resource (bijvoorbeeld /users)	Beschrijving
GET	/users of /users/{id}	Verkrijg de lijst van gebruikers of een specifieke gebruiker.
POST	/users	Maak een nieuwe gebruiker aan.
PUT	/users/{id}	Volledige update van gebruikersgegevens op basis van ID.
PATCH	/users/{id}	Gedeeltelijke update van gebruikersgegevens op basis van ID.
DELETE	/users/{id}	Verwijder gebruiker op basis van ID.

REST API wordt gebruikt voor interactie tussen verschillende systemen en applicaties, bijvoorbeeld tussen frontend en backend.