Introduzione alla gestione delle API

Le API (Application Programming Interfaces) consentono alle applicazioni di comunicare tra loro. La libreria Python requests semplifica l'interazione con le API, permettendo di inviare richieste HTTP e gestire le risposte.

In questa lezione imparerà a utilizzare la libreria requests per inviare richieste API ed elaborare le risposte.

Installazione di requests

Per installare la libreria requests, utilizzi il comando seguente nel terminale:

pip install requests

Dopo l'installazione, può importarla nei suoi script Python:

# Importing requests
import requests

print("Requests library imported successfully")

Inviare una richiesta GET

Il metodo GET viene utilizzato per recuperare dati da un'API. Utilizzi la funzione requests.get() per inviare una richiesta GET:

# Sending a GET request
import requests

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

Inviare una richiesta POST

Il metodo POST viene utilizzato per inviare dati a un'API. Utilizzi la funzione 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

Gestire le risposte

La libreria requests fornisce diversi attributi per gestire le risposte, tra cui:

• response.status_code: codice di stato HTTP.
• response.json(): dati della risposta JSON.
• response.text: contenuto grezzo della risposta.

# 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)

Aggiungere parametri di query

È possibile passare parametri di query alle API utilizzando l'argomento params in una richiesta GET:

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

Aggiungere intestazioni

Le intestazioni consentono di inviare informazioni aggiuntive, come chiavi API o tipi di contenuto, insieme alle richieste:

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

Gestire gli errori

La libreria requests fornisce la gestione integrata delle eccezioni per gli errori relativi alla rete:

# 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)

Errori comuni con requests

Ecco alcuni errori da evitare:

• Non gestire gli errori HTTP con response.raise_for_status().
• Inserire direttamente nello script informazioni sensibili come le chiavi API.
• Dimenticare di specificare il metodo HTTP corretto, ad esempio GET o POST.

Che cosa abbiamo imparato?

In questa lezione ha imparato:

• Come installare e importare la libreria requests.
• Come inviare richieste GET e POST alle API.
• Come gestire le risposte, aggiungere parametri di query e intestazioni e gestire gli errori.

Ottimo lavoro! Passiamo all'argomento successivo.