Wat is een API? Uitleg in gewone taal

API staat voor Application Programming Interface. Vrij vertaald: een aansluitpunt voor programma's. Een veelgebruikte vergelijking is een ober in een restaurant. Jij kiest van de kaart en geeft je bestelling aan de ober. Die brengt hem naar de keuken en komt terug met je eten. Je hoeft niet te weten hoe de keuken werkt.

Bij een API is jouw app de gast, de API de ober en de dienst erachter de keuken. De kaart is de documentatie: een beschrijving van welke vragen je kunt stellen en wat je terugkrijgt. Elke dienst met een API heeft zo'n beschrijving.

Je gebruikt dagelijks API's zonder het te merken. Een kaart op een website, een betaalknop in een webshop of het weerbericht in een app: achter de schermen haalt de app die gegevens via een API op.

Stel, je wilt op je website het weer van vandaag laten zien. Dat gaat zo:

1. 1

   Je app stelt een vraag

   Je app stuurt een verzoek naar een internetadres van de weerdienst, met erin de plaats of de coördinaten. Zo'n adres heet een endpoint. Dit verzoek noem je een request.

2. 2

   De dienst controleert het verzoek

   De weerdienst kijkt of het verzoek klopt en, als dat nodig is, of je een geldige sleutel meestuurt.

3. 3

   Je krijgt een antwoord terug

   Het antwoord, de response, is meestal in JSON: een tekstformaat met vaste labels, zoals {"temperatuur": 14, "neerslag": 0.2}. Het is voor mensen nog redelijk leesbaar en voor je app heel makkelijk.

4. 4

   Je app toont het resultaat

   Je app pakt de temperatuur uit het antwoord en zet die netjes op je pagina, bijvoorbeeld met een zonnetje of een wolk erbij.

Hetzelfde patroon zie je overal: adresgegevens opzoeken bij een postcode, een betaling starten, een e-mail versturen of een tekst laten samenvatten door een AI-model. Elke keer stelt je app een vraag en krijgt het een antwoord terug.

Veel API's willen weten wie er vraagt. Daarvoor krijg je een API-sleutel: een lange, geheime code die je bij elk verzoek meestuurt. Je maakt hem meestal aan in je account bij de dienst. De sleutel is gekoppeld aan jou, en bij betaalde diensten ook aan je rekening.

Behandel een API-sleutel daarom als een wachtwoord. Zet hem nooit in code die bezoekers kunnen zien, zoals JavaScript in de browser, en nooit in code die je op GitHub zet. Wie je sleutel heeft, kan op jouw naam en op jouw kosten de dienst gebruiken.

De gebruikelijke oplossing is een apart bestand .env waarin je geheime waarden zet, en dat bestand toevoegen aan .gitignore zodat het niet naar GitHub gaat. Vraag Claude Code om het zo in te richten. Is een sleutel toch uitgelekt, maak dan direct een nieuwe aan en zet de oude uit.

• Limieten: de meeste API's bepalen hoeveel verzoeken je per minuut of per dag mag doen. Dit heet ook wel rate limiting. Ga je eroverheen, dan krijg je tijdelijk een foutmelding.
• Gratis en betaald: sommige API's zijn gratis tot een bepaald gebruik, andere rekenen per verzoek. Lees vooraf wat het kost en stel waar het kan een maximum in.
• Onthouden: vraag niet elke seconde hetzelfde op. Het weer van vandaag kun je bijvoorbeeld een halfuur bewaren. Dat spaart verzoeken en maakt je app sneller.
• Foutmeldingen: een dienst kan even onbereikbaar zijn. Laat je app dan een nette melding tonen in plaats van vast te lopen.
• Voorwaarden: lees of je de gegevens mag tonen en of je de bron moet vermelden. Dat staat in de voorwaarden van de dienst.

Je hoeft niet te weten hoe je een API-verzoek schrijft. Wel moet je goed beschrijven wat je wilt.

1. 1

   Kies een dienst

   Vraag Claude Code welke API's geschikt zijn voor jouw idee, of noem zelf de dienst die je wilt gebruiken. Kijk op de officiële site wat de voorwaarden zijn.

2. 2

   Geef de documentatie mee

   Plak de link naar de documentatie van de API of het belangrijkste stuk in je opdracht. Dan werkt Claude Code met de actuele regels in plaats van te gokken.

3. 3

   Laat het eerst testen

   Vraag om één los testverzoek, bijvoorbeeld met curl in de terminal, en laat het antwoord uitleggen. Zo zie je wat er terugkomt voordat het in je app wordt verwerkt.

4. 4

   Bouw het in je app

   Daarna schrijft Claude Code de code die de API aanroept, het antwoord verwerkt en fouten netjes afhandelt. De sleutel komt in je .env-bestand.

5. 5

   Controleer het resultaat

   Kijk of de gegevens kloppen en vraag Claude Code wat er gebeurt als de API niet reageert of als je de limiet bereikt.

Een API is niet alleen iets van grote bedrijven. Ook jouw app kan er een hebben. Bouw je bijvoorbeeld een boekingssysteem, dan kan de voorkant van je site via een eigen API de beschikbare tijden ophalen uit je database. Een mobiele app kan via dezelfde API met je systeem praten.

Ook dat kan Claude Code voor je opzetten. Zeg erbij wie er gebruik van mag maken, dan zorgt het ervoor dat niet iedereen zomaar gegevens kan opvragen of wijzigen.