Cos'è un'API e come funziona (spiegato semplice)

API è una di quelle sigle che senti ovunque nel mondo tech, ma che pochi spiegano davvero in modo comprensibile. Eppure il concetto è semplice e, una volta capito, vedrai le API ovunque: dietro ogni app, ogni sito che mostra dati esterni, ogni pagamento online. In questo articolo ti spiego cos'è un'API e come funziona, con esempi concreti e zero gergo inutile.

Cos'è un'API in parole semplici

Un'API (Application Programming Interface) è un insieme di regole che permette a due programmi di comunicare tra loro. È il modo in cui un software chiede dati o servizi a un altro software, senza doverne conoscere il funzionamento interno.

L'analogia più efficace è quella del cameriere al ristorante: tu (l'applicazione) non vai in cucina a cucinare, dici al cameriere (l'API) cosa vuoi, lui lo comunica alla cucina (il server) e ti porta il piatto pronto. Non ti serve sapere come funziona la cucina: ti basta l'interfaccia per ordinare.

A cosa serve un'API

Le API servono a far dialogare sistemi diversi e a riutilizzare funzionalità già pronte. Qualche esempio che usi ogni giorno:

Un'app meteo che mostra le previsioni le ottiene da un'API meteo.
Un sito che accetta pagamenti usa l'API di un servizio di pagamento come Stripe.
Un'app che ti fa accedere con Google usa l'API di autenticazione di Google.
Un'applicazione AI che genera testo chiama l'API di un modello come quelle di OpenAI o Claude.

Senza API, ogni sviluppatore dovrebbe ricostruire da zero ogni funzionalità. Con le API, costruisci sopra il lavoro di altri.

Come funziona un'API

Il funzionamento di base, semplificato:

La tua applicazione invia una richiesta all'API (es. "dammi le previsioni per Milano").
L'API riceve la richiesta e la inoltra al sistema che gestisce i dati.
Il sistema elabora e prepara una risposta.
L'API restituisce la risposta alla tua applicazione (es. i dati meteo), tipicamente in un formato strutturato come il JSON.

Tutto questo avviene in una frazione di secondo, spesso tramite il protocollo HTTP.

Concetti chiave: endpoint e richieste

Due termini che incontrerai sempre parlando di API:

Endpoint: è l'indirizzo specifico a cui invii la richiesta, una sorta di "porta" dedicata a una funzione (es. /meteo/milano).
Richiesta (request): ciò che invii, con un metodo (GET per leggere, POST per creare, ecc.) ed eventuali parametri.
Risposta (response): ciò che ricevi, con i dati e un codice di stato che indica l'esito. Vedi tutti i codici di errore HTTP.

I tipi di API

Esistono diversi stili di API. I più comuni:

REST: lo standard più diffuso, basato su HTTP e semplice da usare. Vedi cos'è una REST API.
GraphQL: permette di chiedere esattamente i dati che servono. Vedi cos'è GraphQL.
SOAP: più vecchio e rigido, ancora usato in contesti enterprise.
WebSocket: per comunicazioni in tempo reale e bidirezionali.

Per chi inizia, REST è il punto di partenza naturale: è ovunque e relativamente facile da capire.

Perché le API sono ovunque

Il software moderno è costruito a blocchi che comunicano via API. Questo approccio porta enormi vantaggi:

Riuso: non reinventi funzionalità complesse.
Specializzazione: ogni servizio fa bene una cosa ed espone un'API.
Integrazione: sistemi diversi collaborano facilmente.
Scalabilità: puoi cambiare l'interno di un servizio senza rompere chi lo usa, finché l'API resta stabile.

Saper usare (e creare) API è una competenza fondamentale per qualsiasi sviluppatore moderno.

In sintesi

Un'API è un insieme di regole che permette a due programmi di comunicare: invii una richiesta a un endpoint e ricevi una risposta strutturata, senza dover conoscere il funzionamento interno dell'altro sistema. Le API sono il tessuto connettivo del software moderno, presenti dietro ogni app e servizio che usi. Per chi sviluppa, capirle è un passo essenziale.

Per approfondire, vedi cos'è una REST API e cos'è GraphQL.