Gestione delle API con requests

Le API (interfacce di programmazione delle applicazioni) permettono alle applicazioni di comunicare tra loro. La libreria requests di Python semplifica l'interazione con le API tramite l'invio di richieste HTTP e la gestione delle risposte.

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

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

pip install requests

Una volta installata, potrà importarla nei Suoi script Python:

# Importing requests
import requests

print("Requests library imported successfully")

Il metodo GET serve per recuperare dati da un'API. Usi 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

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

La libreria requests mette a disposizione diversi attributi per gestire le risposte, tra cui:

• response.status_code: codice di stato HTTP.
• response.json(): dati della risposta in formato 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)

È possibile passare parametri di query alle API usando 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())

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)

La libreria requests offre una 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)

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

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 al prossimo argomento.