home       inleiding       sysadmin       services       tools       bash       werk       nothing      

  • Wat is een API? — endpoint, request, response
  • REST‑principes — GET, POST, PUT, DELETE
  • API‑responses lezen — statuscodes, JSON‑payloads, arrays
     
    API is de afkorting van Application Programming Interface. Dat is de formele naam,
    maar voor beginners is het vaak duidelijker om het in drie delen te bekijken: application, programming en interface.
    Elk deel vertelt iets over wat een API precies doet en waarom het zo’n centrale rol speelt in moderne data‑stromen.
     
    APIs en REST vormen het moment waarop moderne data gaat bewegen: niet meer alleen bestanden lezen, maar begrijpen hoe toepassingen met elkaar praten. Hieronder staat een volledig uitgewerkte, rustige en beginner‑veilige tekst over APIs en REST.
     
    application — een toepassing die iets aanbiedt
    Een application is gewoon een programma of dienst: een website, een app, een server, een cloud‑dienst.
    Die toepassing biedt iets aan: gegevens, functies, acties.
    Voorbeelden:
  • een weer‑app die temperatuurgegevens aanbiedt
  • een webshop die productinformatie aanbiedt
  • een kaartendienst die locaties aanbiedt
    De API is de deur waarlangs je dat kunt opvragen.
     
    programming — een manier om ermee te praten
    het woord programming betekent niet dat je moet kunnen programmeren.
    het betekent dat de API gemaakt is om door andere toepassingen gebruikt te worden.
    een API is dus geen webpagina voor mensen, maar een toegangspunt voor software.
    toch kun je als mens perfect begrijpen wat er gebeurt, omdat de antwoorden meestal gewoon JSON zijn.
     
    Interface — de afgesproken vorm van de communicatie
    een interface is een afspraak:
  • hoe je een vraag stelt (GET, POST, …)
  • naar welk adres (endpoint)
  • in welke vorm (meestal JSON)
  • wat je terugkrijgt (ook JSON)
    Het is een soort contract: “Als jij dit vraagt, krijg je dat terug.”

APIs en REST

Toepassingen praten met elkaar via APIs . Een API (Application Programmers Interface) is een toegangspunt waar je informatie kunt opvragen of acties kunt uitvoeren. Moderne APIs gebruiken bijna altijd JSON om gegevens te versturen. In deze sectie leer je hoe een API‑request werkt, hoe een API‑response eruitziet en wat REST‑methodes betekenen.
 

Wat een API eigenlijk is

Een API is een deur waarlangs een toepassing informatie aanbiedt. Je stuurt een vraag (request) en je krijgt een antwoord (response).
Dat antwoord bevat meestal JSON‑data.
 
Belangrijke onderdelen:

  • een endpoint (het adres van de API)
  • een request (de vraag die je stelt)
  • een response (het antwoord dat je krijgt)
  • een statuscode (of het gelukt is)
     
    APIs worden gebruikt door websites, apps, servers en diensten.

Een eenvoudig API‑request

Een request is een vraag naar een endpoint.
Bijvoorbeeld:
GET https://api.example.com/gebruiker/42
 
Dit betekent: “Geef mij de gegevens van gebruiker 42.”

Een eenvoudig API‑response

Het antwoord is meestal JSON:

{
  "id": 42,
  "naam": "Anna",
  "stad": "Mechelen",
  "actief": true
}

 
Je ziet dezelfde structuren terug als in de vorige hoofdstukken: objecten, sleutels, waarden.
 

Statuscodes

 
Een API‑response bevat altijd een statuscode. Enkele veelvoorkomende:

  • 200 — gelukt
  • 201 — nieuw item aangemaakt
  • 400 — fout in de vraag
  • 401 — niet ingelogd
  • 404 — niet gevonden
  • 500 — fout in de server

Je hoeft ze niet allemaal te kennen; het belangrijkste is dat ze aangeven of de vraag gelukt is.

REST‑methodes

REST is een manier om APIs te organiseren. De methode van het request zegt wat je wil doen.

  • GET — informatie opvragen
  • POST — iets nieuws aanmaken
  • PUT — iets volledig vervangen
  • PATCH — iets gedeeltelijk aanpassen
  • DELETE — iets verwijderen

Voorbeeld van een POST‑request:

POST https://api.example.com/gebruiker

 
Met JSON‑data:

{
  "naam": "Tom",
  "stad": "Tongeren"
}

 

Hoe je een API‑response leest (micro‑stapjes)

  • Kijk naar de statuscode: is het gelukt?
  • Bekijk de JSON‑structuur: object of lijst?
  • Lees de sleutels één voor één.
  • Herken geneste objecten en lijsten.
  • Koppel de data aan wat je vroeg.
     
    APIs lezen is vooral JSON herkennen in beweging.

Waar je APIs tegenkomt in de praktijk

  • apps die data ophalen (weer, nieuws, kaarten)
  • websites die informatie tonen uit een database
  • systemen die met elkaar praten (bijv. facturatie, logistiek)
  • IoT‑toestellen die gegevens doorsturen
  • automatisaties en integraties
     
    APIs zijn overal waar toepassingen met elkaar communiceren.

Wat je na deze sectie kunt

  • begrijpen wat een API is
  • een endpoint herkennen
  • een request en response lezen
  • JSON interpreteren in een API‑antwoord
  • REST‑methodes herkennen (GET, POST, PUT, DELETE)