Wat een API is · Code met Martin

Ontdek hoe websites met elkaar praten – en hoe jouw website kan vragen naar het weer, kaarten of AI.

Een ober tussen twee keukens

Stel je een restaurant voor. Jij (je website) wilt eten bestellen, maar je mag niet de keuken in (een vreemde dienst – weer, kaarten, AI). Daar is de ober voor – die neemt je bestelling mee naar de keuken en brengt je het gerecht terug.

Die ober heet een API (Application Programming Interface). Het is een afgesproken manier voor programma’s om elkaar om data te vragen:

Je website stuurt een verzoek (“Hoe wordt het weer morgen in Brno?”).
De API geeft het door aan de dienst die het antwoord weet.
De dienst stuurt een antwoord terug in een afgesproken formaat.

Ik laat je zien: JSON – een gedeelde taal

Programma’s antwoorden elkaar in het JSON-formaat. Het lijkt bijna op een JavaScript-object, dat je al kent uit Tovenaar:

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["Saturday", "Sunday"]
}

Tekst staat tussen aanhalingstekens, getallen niet.
true/false ken je al uit voorwaarden.
Vierkante haken = een lijst, accolades = een object.

Probeer het nu – open dit adres in je browser (een echt weer-API, gratis, geen registratie nodig):

https://api.open-meteo.com/v1/forecast?latitude=49.19&longitude=16.61&current_weather=true

Je ziet JSON met het huidige weer in Brno. Geen graphics – alleen pure data. Jij bouwt de graphics eromheen!

💡

API’s zijn overal. Als een mobiele app een voorspelling, busrooster of kaart toont, heeft die bijna nooit die data zelf – hij vraagt via een API. Nu leer je hetzelfde te doen.

Nu jij 💪

Open het adres hierboven in je browser en zoek de huidige temperatuur en windsnelheid in het antwoord.
Probeer latitude en longitude in het adres te veranderen naar de coördinaten van je eigen stad (vind ze op een kaartdienst – rechtsklik → “What’s here?”).
Schrijf 2–3 ideeën voor je project op over welke externe data nuttig zou zijn op je website:

🏫 Schoolwebsite – ideeën

Weer voor een schoolreis, een kaart met de locatie van de school, een lunchmenu van de kantine-API (als die er is), vakanties en vrije dagen.

🙋 Persoonlijke website – ideeën

Weer in je stad, een kaart met plekken waar je bent geweest, een AI-chatbot die bezoekers vragen over jou beantwoordt.

🌍 Reisdagboek – ideeën

Een kaart met pinnen voor je reizen, weer op je volgende bestemming, valutaomrekening voor je reisbudget.

⚽ Clubwebsite – ideeën

Weer voor de wedstrijd in het weekend, een kaart van het veld voor bezoekende teams, een AI-helper die de regels van voetbal uitlegt.

✅

Controle: Je kunt uitleggen wat een API is (een ober tussen programma’s) en JSON herkennen. Je hebt een echt API-antwoord in je browser gezien.

Wat neem je mee uit deze les

API = een afgesproken manier voor programma’s om elkaar om data te vragen.
Antwoorden komen in JSON – objecten en lijsten zoals in JavaScript.
In de volgende les haal je data met fetch rechtstreeks in je website.