APIverzoeken

APIverzoeken zijn verzoeken die een client aan een API stuurt om een resource te verkrijgen of een bewerking uit te voeren. Ze ontstaan meestal via het netwerk met behulp van het HTTP(S) protocol en bestaan uit een endpoint-URL die de gewenste resource aanduidt, een HTTP-methode (zoals GET, POST, PUT, PATCH, DELETE), optionele headers (bijvoorbeeld Accept, Content-Type en Authorization) en vaak parameters in de querystring of een berichtlichaam met data (meestal JSON).

Veel API’s volgen principes zoals REST of gebruiken alternatieve ontwerpen zoals GraphQL. De gebruikte methode bepaalt wat er gebeurt: GET vraagt data op zonder bij te werken, POST maakt doorgaans een nieuwe resource aan, PUT en PATCH voeren updates uit, en DELETE verwijdert een resource. Verzoeken moeten meestal stateless zijn en kunnen idempotent zijn, afhankelijk van de methode. Het antwoord bevat een statuscode en een responslichaam met data of foutinformatie. Veelvoorkomende statuscodes zijn 200, 201, 204, 400, 401, 403, 404 en 500. De respons kan gegevens in JSON of XML bevatten.

Beveiliging en beleid spelen een belangrijke rol: authenticatie en autorisatie gebeuren vaak via API-sleutels, OAuth of tokens; er kunnen beperkingen zijn op het aantal verzoeken (rate limiting) en CORS-regels voor webtoepassingen. Versiebeheer en duidelijke documentatie zijn essentieel voor compatibiliteit, onder andere bij wijzigingen in endpoints of data-formaten. APIverzoeken vormen de kern van moderne integraties tussen systemen en diensten.