REST
REST (Representational State Transfer) is een architectuurstijl voor het ontwerpen van web-API's. Een API die de REST-principes volgt, heet een RESTful API. REST maakt gebruik van standaard HTTP-methoden en behandelt data als resources met een eigen URL.
HTTP-methoden in REST
| Methode | Actie | Idempotent |
|---|
GET | Opvragen | Ja |
POST | Aanmaken | Nee |
PUT | Vervangen | Ja |
PATCH | Gedeeltelijk bijwerken | Nee |
DELETE | Verwijderen | Ja |
Principes
- Stateless — elke aanvraag bevat alle benodigde informatie; de server slaat geen sessie op
- Resource-gebaseerd — alles is een resource met een URL:
/gebruikers/42
- Uniforme interface — standaard HTTP-methoden en statuscodes
REST vs. alternatieven
| REST | GraphQL | gRPC |
|---|
| Protocol | HTTP | HTTP | HTTP/2 |
| Formaat | JSON/XML | JSON | Protobuf |
| Flexibiliteit | Gemiddeld | Hoog | Laag |
Zie ook
- api — wat een API is
- http — het protocol dat REST gebruikt
- json — veelgebruikt formaat voor REST-responses
- oauth — authenticatie voor REST-API's