Salta ai contenuti

Prerequisiti e setup

Per leggere il corso e usare i pulsanti “Esegui” non serve nulla. Per eseguire gli esempi sul tuo computer ti servono:

  1. Python 3.12 o superiore: python3 --version.
  2. Un ambiente virtuale con le librerie usate nel corso:
    Finestra del terminale
    python3 -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activate
    pip install httpx pydantic jsonschema ijson orjson
  3. Verifica:
    Finestra del terminale
    python3 -c "import httpx; print(httpx.get('https://corso-api-json.giuseppebosi.com/api/v1/health').json())"
    Atteso: {'status': 'ok', 'public_dataset': True}.

curl è preinstallato su macOS, Linux e Windows 10/11 (curl --version). È lo strumento con cui, in ogni capitolo, guarderemo la richiesta “nuda”:

terminale
curl -s https://corso-api-json.giuseppebosi.com/api/v1/health
curl
il programma: fa una richiesta HTTP e stampa la risposta
-s
silent: niente barra di avanzamento, solo il corpo della risposta
https://…/health
l'URL: schema https, host, percorso /api/v1/health. Senza altre opzioni curl fa una GET

Atteso: {"status":"ok","public_dataset":true}.

Per filtrare e abbellire il JSON dalla riga di comando useremo anche jq (facoltativo: dove manca, python3 -m json.tool formatta senza filtrare). Installazione: brew install jq (macOS), sudo apt install jq (Linux), winget install jqlang.jq (Windows). Verifica: jq --version.

Il capitolo 2 della Sezione 2 è dedicato interamente a curl.

  • fetch is not defined → Node più vecchio di 18: aggiorna.
  • Errore SSL/certificato → orologio del computer sbagliato o proxy aziendale.
  • 429 Too Many Requests → hai superato il limite per minuto: aspetta qualche secondo.