GET-gegevens ophalen uit een API

Je board kan op dezelfde manier gegevens van internet ophalen als een browser: door een HTTP-verzoek naar een URL te sturen. 🌐

Een GET-verzoek vraagt een server om bepaalde gegevens te sturen. Het leest alleen gegevens en verandert niets aan de andere kant.

Voordat je een verzoek verstuurt, moet je ESP al met WiFi verbonden zijn. Zonder netwerkverbinding is er geen bestemming om het verzoek naartoe te sturen.

De bibliotheek HTTPClient geeft je eenvoudige functies om verzoeken te maken. Voeg de bibliotheek bovenaan je sketch toe.

Maak een object van HTTPClient en wijs het met begin() naar je doel-URL. Daarmee stel je het verzoek in dat je gaat verzenden.

Roep GET() aan om het verzoek te versturen. De functie retourneert een HTTP-statuscode die aangeeft of de server je verzoek accepteerde.

Een code van 200 betekent dat het is gelukt. Controleer de code altijd voordat je de gegevens vertrouwt, want 404 of 500 betekent dat er iets misging.

Wanneer de status goed is, haal je de daadwerkelijke gegevens op met getString(). Dit is de tekst die de server naar je terugstuurde.

Roep end() aan wanneer je klaar bent. Daarmee sluit je de verbinding en geef je geheugen vrij, zodat het volgende verzoek schoon kan beginnen.

Een negatieve statuscode komt niet van de server. Dit betekent dat het verzoek aan jouw kant is mislukt, vaak door ontbrekende wifi of een onjuiste URL.

Voeg een vertraging tussen verzoeken toe, zodat je de API niet overspoelt. De meeste diensten beperken hoe vaak je gegevens mag opvragen.

Je hebt verbinding gemaakt, GET() aangeroepen, gecontroleerd op 200, de antwoordtekst met getString() gelezen en met end() afgesloten. Dat is een volledige lezing van het web. 🎉