🏋️ La palestra delle API

Anatomia di una richiesta

Molte API si interrogano con un semplice indirizzo web, come una pagina. Tocca ogni pezzo colorato per scoprire che cosa significa.

Anatomia di una risposta: il JSON

La risposta arriva quasi sempre in formato JSON (JavaScript Object Notation). Sembra complicato, ma ha solo quattro regole:

I codici di stato: com'è andata?

Ogni risposta porta un numero che dice com'è andata. Basta ricordare le centinaia.

Laboratorio: interroga un'API vera

Scegli un servizio, cambia i parametri e guarda l'indirizzo che si costruisce. Poi premi «Invia la richiesta». Tutte le API sono gratuite e non richiedono chiave. Se non c'è connessione, la palestra usa risposte di esempio.

Missioni

Dieci missioni da svolgere nel Laboratorio (si può tenere aperta questa scheda e passare dall'una all'altra). Le missioni si completano da sole quando la richiesta giusta è stata inviata, oppure scrivendo la risposta qui.

La procedura per usare un'API

Valida per qualunque API, da quella del meteo a quella di un modello di intelligenza artificiale.

Dall'API all'app: il prompt pronto

Dopo aver provato una richiesta nel Laboratorio, premi il pulsante: il prompt conterrà l'indirizzo esatto che hai usato.

Invia prima una richiesta nel Laboratorio.

Come appare una richiesta nel codice

Non serve saperlo scrivere: serve riconoscerlo quando l'IA costruisce un'app. Sono poche righe di JavaScript.

// 1. l'indirizzo della richiesta
const indirizzo = "https://api.open-meteo.com/v1/forecast?latitude=45.69&longitude=9.67&current=temperature_2m";

// 2. invio la richiesta e aspetto la risposta
const risposta = await fetch(indirizzo);

// 3. controllo il codice di stato
if (!risposta.ok) { alert("Errore " + risposta.status); }

// 4. leggo il JSON e prendo il dato con il suo percorso
const dati = await risposta.json();
const temperatura = dati.current.temperature_2m;

// 5. lo mostro nella pagina
document.body.textContent = "Ora ci sono " + temperatura + " °C";

Le API dei modelli di intelligenza artificiale

Anche le chat funzionano così: l'app che vediamo prepara una richiesta per l'API del modello, la invia e mostra la risposta. Le differenze rispetto al meteo sono tre: serve una chiave, la richiesta si invia con il metodo POST (i dati viaggiano dentro la richiesta, non nell'indirizzo) e si paga a token. Qui puoi costruire una richiesta e vedere che cosa contiene, senza inviarla davvero.

Quanto costa?

Le API dei modelli si pagano in base ai token letti (input) e scritti (output). I prezzi cambiano spesso e variano molto tra modelli: inserisci quelli aggiornati del servizio che ti interessa. In italiano, in media, un token vale circa 3-4 caratteri.

Le domande da fare prima di adottare una piattaforma «con IA»