Een API (Application Programming Interface) is een gestandaardiseerde manier waarop software met andere software communiceert. REST is de meest gebruikte stijl voor webgebaseerde APIs.
Een REST API (REpresentational State Transfer) gebruikt HTTP als protocol en JSON als dataformaat. Elke resource heeft een URL en je gebruikt HTTP-methoden om er mee te werken:
| Methode | Actie |
|---|---|
GET | Resource ophalen |
POST | Nieuwe resource aanmaken |
PUT / PATCH | Resource bijwerken |
DELETE | Resource verwijderen |
# Weer ophalen via een publieke API
curl https://wttr.in/Amsterdam?format=j1
# GitHub API: repositories van een gebruiker ophalen
curl https://api.github.com/users/octocat/repos
# Met authenticatie (Bearer token)
curl -H "Authorization: Bearer $TOKEN" https://api.voorbeeld.nl/data
REST APIs gebruiken HTTP-statuscodes: 200 OK, 201 Created, 400 Bad Request, 401 Unauthorized, 404 Not Found, 500 Internal Server Error.