APIverzoek

Een API-verzoek is een bericht dat een client naar een API-service stuurt om een bewerking uit te voeren of gegevens op te halen. In de praktijk gebeurt dit meestal via HTTP of HTTPS, en de meest gebruikte methode is gebaseerd op HTTP-methoden zoals GET, POST, PUT, PATCH en DELETE.

Een API-verzoek bestaat uit meerdere onderdelen: een basis-URL die de host en API-versie aangeeft, een endpoint dat de beoogde bron aanduidt, en een HTTP-methode. Daarnaast kunnen kopteksten (headers) worden meegestuurd, bijvoorbeeld voor authenticatie (Authorization: Bearer ...), voor inhoudstype (Content-Type: application/json) en voor caching. Indien nodig bevat een verzoek ook queryparameters in de URL. Voor POST-, PUT- of PATCH-verzoeken kan een body meegestuurd worden met de gegevens in formats zoals JSON of XML.

Het antwoord van de API levert een statuscode, headers en mogelijk een body met gegevens. Veelgebruikte statuscodes zijn 200 (OK), 201 (Created), 204 (No Content) voor succes zonder payload, en foutcodes zoals 400 (Bad Request), 401 (Unauthorized), 403 (Forbidden), 404 (Not Found), 429 (Too Many Requests) en 500 (Internal Server Error). Authenticatie kan via API-sleutels, OAuth-tokens of andere mechanismen verlopen. Providers kunnen ook regels voor rate limiting toepassen.

Security en best practices omvatten het afdwingen van HTTPS, het toepassen van least-privilege bij authenticatie, het valideren en ontsmetten van invoer, en het correct afhandelen van fouten en retries. Voor ontwikkelaars is het nuttig om het API-contract te documenteren met eindpunten, parameters en voorbeeldverzoeken, zodat integraties betrouwbaar en consistent verlopen.

Een typische query en opvolgactie: een client met een geldige token vraagt via GET /users/123 gegevens op bij een gebruikers-API, terwijl een POST /users een nieuw account aanmaakt met een JSON-lichaam.