Cos'è un'API?
Il menu di quello che un server sa fare
⏱ Stima ~4 min
01 · Leggi
Un'API (Application Programming Interface, interfaccia di programmazione dell'applicazione) è un insieme di regole che definisce quali richieste un server accetta e cosa risponde.
Quando uno sviluppatore costruisce un server, non lascia che chiunque invii qualsiasi richiesta a caso. Crea un'API — un elenco chiaro degli endpoint (URL) che si possono chiamare, i dati da inviare e cosa ci si aspetta di ricevere.
Ogni app che usi si basa su API. Quando l'app del meteo mostra le previsioni, sta chiamando un'API meteo. Quando accedi a un sito, sta chiamando un'API di autenticazione. Quando scorri il feed social, sta chiamando un'API per caricare il prossimo batch di post.
💡 Immagina cosìUn'API è come il menu di un ristorante. Il menu ti dice cosa puoi ordinare, cosa contiene ogni piatto e quanto costa. Non puoi entrare in cucina e fare quello che vuoi — scegli dal menu. Un'API funziona allo stesso modo: dice alla tua app cosa può chiedere al server.
Punti chiave
- API = Application Programming Interface
- Definisce il "menu" delle richieste che un server accetta
- Ogni voce del menu si chiama endpoint (un URL specifico + method)
- Le API permettono a sistemi software diversi di comunicare senza conoscere i dettagli interni dell'altro
02 · Esempio di codice
Ecco com'è fatta una tipica API per un blog. Ogni endpoint è la combinazione di HTTP method + percorso URL.
Blog API Endpoints
GET /api/posts → Get all blog posts
GET /api/posts/15 → Get post #15
POST /api/posts → Create a new post
PUT /api/posts/15 → Update post #15
DELETE /api/posts/15 → Delete post #15
User API Endpoints
GET /api/users → Get all users
GET /api/users/42 → Get user #42's profile
POST /api/users → Create a new user (sign up)
PUT /api/users/42 → Update user #42's profile
DELETE /api/users/42 → Delete user #42's account
Nota il pattern: l'URL dice su cosa stai operando (/posts o /users), il numero dice quale specifico elemento, il HTTP method dice cosa vuoi fare. Questo schema coerente rende le API facili da intuire e da usare.
03 · Quiz
Un'app meteo sul cellulare mostra le previsioni di oggi. Come ottiene quei dati?
- Le previsioni sono scritte direttamente nel codice dell'app
- L'app legge i sensori del telefono
- L'app chiama un'API meteo per ottenere i dati aggiornati
- L'app fa scraping di un sito meteo
04 · Completa
L'API definisce quali _____ un server accetta.
Altre lezioni di questo capitolo
⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.
※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.