Chris Stegeman | Jan 31, 2023

js31 | API base

Voorkennis:

  • JS basis

Doelen:

  • Begrijpen wat een API is
  • Verschillende APIs uitproberen in de browser
  • Inzicht krijgen in JSON
  • De browser op een nette manier JSON laten weergeven met een plugin

Beschrijving


Wat is een API?

Wanneer je een lijst met gegevens uit een database wilt gebruiken in je webpagina, kan dat via PHP. Met PHP maak je connectie met bijv. MySQL, haal je de data op, en genereer je HTML-output, bijv. een tabel met user-gegevens.
Een API (Application Programming Interface) doet ook dat eerste backend deel: connectie met een database maken, en data ophalen.
Maar een API geeft alleen die data weer terug in JSON-formaat en geen HTML!
userHtmlTable
Je kunt zo in een HTML-page, met Javascript, die JSON-data ophalen en verwerken tot HTML .
Bekijk het schema hiernaast (klik om te vergroten) =>
A) De PHP haalt data uit de Database, verwerkt deze in de HTML en geeft die terug aan de webpagina
B) De API haalt data uit de Database, en stuurt die in JSON terug naar de client, samen met een JS file
Uiteindelijk wordt de HTML bij A) op de server geschreven door PHP en bij B) op de client gemaakt met Javascript.
API_vs_BE_C

opdracht

Open handleiding js31_api_base.

  • Bekijk bij 1: "HTML-opbouw vanuit API" het proces, hoe je van een API tot een website komt
  • Bekijk bij 2: "API en JSON" verschillende voorbeelden van API's
    • Bekijk alle links van API's in je browser
    • Installeer een plugin in je browser om de JSON beter leesbaar weer te geven
  • Bekijk bij 3: "AJAX" hoe je met een Javascript AJAX-request, data uit de API kan ophalen

vervolg

Ga hierna verder met js32b_api_html. Daarin wordt uitgelegd:

  • Hoe je een AJAX request op een API uitvoert
  • Dat je een API via AJAX kan laden
  • Hoe je op een andere (betere) manier Ga hierna verder met AJAX kan gebruiken (js32_json_ajax) dan in bovenstaande oefening (via plain JS)