Prerequisiti e setup
Per leggere il corso e usare i pulsanti “Esegui” non serve nulla. Per eseguire gli esempi sul tuo computer ti servono:
- Python 3.12 o superiore:
python3 --version. - Un ambiente virtuale con le librerie usate nel corso:
Finestra del terminale python3 -m venv .venv && source .venv/bin/activate # Windows: .venv\Scripts\activatepip install httpx pydantic jsonschema ijson orjson - Verifica:
Atteso:
Finestra del terminale python3 -c "import httpx; print(httpx.get('https://corso-api-json.giuseppebosi.com/api/v1/health').json())"{'status': 'ok', 'public_dataset': True}.
- Node.js 22 o superiore:
node --version. Node 22 esegue i file.tsdirettamente (node --experimental-strip-types file.ts; da Node 23 il flag non serve più) e hafetchintegrato. - Una cartella di lavoro con le librerie usate nel corso:
Finestra del terminale mkdir corso-json && cd corso-json && npm init -ynpm install zod ajvnpm install -D typescript @types/node - Verifica (salva come
check.ts):const r = await fetch("https://corso-api-json.giuseppebosi.com/api/v1/health");console.log(await r.json());Atteso:Finestra del terminale node --experimental-strip-types check.ts{ 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”:
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 unaGET
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.
Se qualcosa non va
Sezione intitolata “Se qualcosa non va”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.