API's gebruiken met requests

API's (interfaces voor applicatieprogrammering) zorgen ervoor dat toepassingen met elkaar kunnen communiceren. De Python-bibliotheek requests maakt het eenvoudig om met API's te communiceren door HTTP-verzoeken te versturen en antwoorden te verwerken.

In deze les leer je hoe je de bibliotheek requests gebruikt om API-verzoeken te versturen en antwoorden te verwerken.

Gebruik de volgende opdracht in je terminal om de bibliotheek requests te installeren:

pip install requests

Na de installatie kun je de bibliotheek in je Python-scripts importeren:

# Importing requests
import requests

print("Requests library imported successfully")

De methode GET wordt gebruikt om gegevens uit een API op te halen. Gebruik de functie requests.get() om een GET-verzoek te versturen:

# Sending a GET request
import requests

response = requests.get("https://jsonplaceholder.typicode.com/posts/1")
print(response.json())  # Outputs the JSON response

De methode POST wordt gebruikt om gegevens naar een API te versturen. Gebruik de functie requests.post():

# Sending a POST request
import requests

payload = {"title": "foo", "body": "bar", "userId": 1}
response = requests.post("https://jsonplaceholder.typicode.com/posts", json=payload)
print(response.json())  # Outputs the response

De bibliotheek requests biedt verschillende kenmerken voor het verwerken van antwoorden, zoals:

• response.status_code: HTTP-statuscode.
• response.json(): JSON-gegevens uit het antwoord.
• response.text: Onbewerkte inhoud van het antwoord.

# Handling responses
response = requests.get("https://jsonplaceholder.typicode.com/posts/1")
if response.status_code == 200:
    print("Success:", response.json())
else:
    print("Failed with status code:", response.status_code)

Je kunt queryparameters aan API's doorgeven met het argument params in een GET-verzoek:

# Adding query parameters
params = {"userId": 1}
response = requests.get("https://jsonplaceholder.typicode.com/posts", params=params)
print(response.json())

Met headers kun je aanvullende informatie, zoals API-sleutels of inhoudstypen, met je verzoeken meesturen:

# Adding headers
headers = {"Authorization": "Bearer YOUR_API_KEY"}
response = requests.get("https://jsonplaceholder.typicode.com/posts", headers=headers)
print(response.status_code)

De bibliotheek requests biedt ingebouwde afhandeling van uitzonderingen voor netwerkgerelateerde fouten:

# Handling errors
try:
    response = requests.get("https://jsonplaceholder.typicode.com/invalid")
    response.raise_for_status()
except requests.exceptions.HTTPError as err:
    print("HTTP error occurred:", err)
except requests.exceptions.RequestException as err:
    print("Request error occurred:", err)

Hier zijn enkele fouten die je moet vermijden:

• HTTP-fouten niet afhandelen met response.raise_for_status().
• Gevoelige informatie, zoals API-sleutels, hardcoderen in het script.
• Vergeten de juiste HTTP-methode op te geven, zoals GET of POST.

In deze les heb je geleerd:

• Hoe je de bibliotheek requests installeert en importeert.
• Hoe je GET- en POST-verzoeken naar API's verstuurt.
• Hoe je antwoorden verwerkt, queryparameters en headers toevoegt en fouten afhandelt.

Goed gedaan! Laten we doorgaan naar het volgende onderwerp.