Cos'è un'API · Code con Martin

Scopri come i siti web parlano tra loro – e come il tuo sito web può chiedere meteo, mappe o AI.

Un cameriere tra due cucine

Immagina un ristorante. Tu (il tuo sito web) vuoi ordinare cibo, ma non puoi entrare in cucina (un servizio esterno – meteo, mappe, AI). Per questo c’è il cameriere – prende il tuo ordine, lo porta in cucina, e ti riporta il piatto finito.

Quel cameriere si chiama API (Application Programming Interface). È un modo concordato perché i programmi si chiedano dati l’un l’altro:

Il tuo sito web invia una richiesta (“Com’è il tempo domani a Brno?”).
L’API la passa al servizio che conosce la risposta.
Il servizio restituisce una risposta in un formato concordato.

Te lo mostro: JSON – un linguaggio comune

I programmi rispondono l’un l’altro in formato JSON. Assomiglia quasi a un oggetto JavaScript, che già conosci dal Mago:

{
  "mesto": "Brno",
  "teplota": 21,
  "slunecno": true,
  "dny": ["Saturday", "Sunday"]
}

Il testo va tra virgolette, i numeri no.
true/false li conosci già dalle condizioni.
Parentesi quadre = una lista, parentesi graffe = un oggetto.

Provalo subito – apri questo indirizzo nel browser (è un’API meteo vera, gratuita, senza registrazione):

https://api.open-meteo.com/v1/forecast?latitude=49.19&longitude=16.61&current_weather=true

Vedrai JSON con il meteo attuale a Brno. Niente grafica – solo dati puri. A te costruire la grafica intorno!

💡

Le API sono ovunque. Quando un’app mobile ti mostra una previsione, un orario degli autobus o una mappa, quasi mai ha quei dati da sola – li chiede tramite un’API. Ora stai imparando a fare la stessa cosa.

Ora tocca a te 💪

Apri l’indirizzo sopra nel browser e trova la temperatura attuale e la velocità del vento nella risposta.
Prova a cambiare latitude e longitude nell’indirizzo con le coordinate della tua città (le trovi su un servizio mappe – clic destro → “What’s here?”).
Annota 2–3 idee per il tuo progetto su quali dati esterni sarebbero utili sul tuo sito web:

🏫 Sito web scolastico – idee

Meteo per una gita scolastica, una mappa con la posizione della scuola, un menu mensa dall’API della mensa (se ce l’ha), vacanze e pause scolastiche.

🙋 Sito web personale – idee

Meteo nella tua città, una mappa dei posti dove sei stato, un chatbot AI che risponde ai visitatori sulle tue cose.

🌍 Diario di viaggio – idee

Una mappa con spille per i tuoi viaggi, meteo alla prossima destinazione, conversione valuta per il budget di viaggio.

⚽ Sito web del club – idee

Meteo per la partita del weekend, una mappa del campo per le squadre ospiti, un aiutante AI che spiega le regole del calcio.

✅

Controllo: Puoi spiegare cos’è un’API (un cameriere tra programmi) e riconoscere JSON. Hai visto una risposta API vera nel browser.

Cosa porti via da questa lezione

API = un modo concordato perché i programmi si chiedano dati l’un l’altro.
Le risposte arrivano in JSON – oggetti e liste come in JavaScript.
Nella prossima lezione tirerai dati da un’API direttamente nel tuo sito web con fetch.