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:

1. La tua applicazione invia una richiesta all'API (es. "dammi le previsioni per Milano").
2. L'API riceve la richiesta e la inoltra al sistema che gestisce i dati.
3. Il sistema elabora e prepara una risposta.
4. 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.