Summary  
This chapter introduces how to use an HTTP client library to send GET requests to an API endpoint, check response status codes, parse JSON responses, and printing the retrieved data.

General domain of usage  
Retrieving external data from web services

Le API, o **Application Programming Interfaces**, sono strumenti fondamentali che permettono a diversi sistemi software di comunicare tra loro. Ogni giorno interagisci con le API: quando controlli il meteo sul tuo telefono, visualizzi i feed dei social media o cerchi le ultime notizie, le tue applicazioni utilizzano le API per recuperare queste informazioni da server remoti. Per gli sviluppatori Python, le API sono estremamente importanti perché consentono ai programmi di connettersi a fonti di dati e servizi esterni, rendendo le applicazioni più dinamiche e potenti. Ad esempio, potresti utilizzare un'API per ottenere prezzi azionari in tempo reale, recuperare previsioni meteo o accedere a un database di curiosità.

import requests

response = requests.get("https://catfact.ninja/fact")
print(response.text)

Nel codice sopra, si importa innanzitutto la libreria `requests`, uno strumento molto diffuso per effettuare richieste HTTP in Python. La funzione `requests.get()` invia una **richiesta GET** all'API Cat Facts all'indirizzo `https://catfact.ninja/fact`. Questa richiesta chiede al server di restituire un fatto casuale sui gatti. La risposta del server viene memorizzata nella variabile `response` e `response.text` contiene il testo grezzo della risposta del server, che viene stampato sulla console.

import requests

response = requests.get("https://catfact.ninja/fact")

if response.status_code == 200:
    print("Success! Here is your cat fact:")
    print(response.json()["fact"])
else:
    print(f"Error: Received status code {response.status_code}")

I codici di stato HTTP sono numeri che indicano se la richiesta API è andata a buon fine o se si è verificato un errore. Un codice di stato **200** significa "OK"—la richiesta è stata eseguita correttamente e il server ha inviato i dati richiesti. Altri codici, come **404** ("Non trovato") o **500** ("Errore del server"), indicano dei problemi. Quando si lavora con le API, è sempre importante controllare il codice di stato per assicurarsi che la richiesta sia riuscita prima di utilizzare i dati nella risposta.

Quale metodo HTTP viene comunemente utilizzato per recuperare dati da un'API?

Impara a interagire con API aperte utilizzando Python, a elaborare e analizzare dati provenienti da servizi web reali e a sviluppare applicazioni pratiche senza necessità di registrazione o pagamento. Questo corso è pensato per studenti di livello intermedio di Python desiderosi di ampliare le proprie competenze nel recupero e nella manipolazione dei dati tramite API.

Apprendere i concetti fondamentali delle API, come effettuare richieste HTTP in Python e come gestire le risposte dalle API aperte.

Approfondimento sul lavoro con API aperte tramite il recupero e l'analisi di dati pubblici, come informazioni meteorologiche e spaziali.

Applicazione di tecniche avanzate per l'utilizzo delle API, inclusa la gestione dei parametri di query, l'elaborazione di elenchi di dati e la visualizzazione di dati di base.

Che cos'è un'API?

1. Cosa significa API?

2. Quale metodo HTTP viene comunemente utilizzato per recuperare dati da un'API?