Stagione 43: API REST

Le API REST, il modo più diffuso sul web di far parlare i programmi tra loro. L'idea geniale: far parlare i programmi usando il web stesso, la stessa macchina che muove i browser. REST modella ogni cosa come una risorsa, un sostantivo, e le da' un indirizzo come le pagine del web; agisce su di essa con pochissimi verbi universali, gli stessi per tutte (leggere, creare, modificare, cancellare): l'interfaccia uniforme. Tiene ogni richiesta completa in se', senza memoria sul server, cosi' qualunque macchina puo' servirti; risponde con un linguaggio condiviso di codici di stato; e scambia rappresentazioni, fotografie delle cose, quasi sempre scritte nel formato di testo comune, il JSON. Un'API ben fatta e' un prodotto, progettato con empatia per chi la userà: coerente, prevedibile, stabile come una promessa. Con l'onestà sui suoi limiti (dare troppo o troppo poco) e sulle alternative (GraphQL, gRPC): nessuno strumento è il migliore in assoluto. Le API sono il tessuto connettivo che fa di tanti sistemi separati un ecosistema. Chiude l'arco del codice accanto a Redis e Kafka.

Episodi

10 episodi
EP 0010
Le API in sintesi, e il tessuto connettivo del web

Le API in sintesi, e il tessuto connettivo del web

Il ritratto unitario: REST è far parlare i programmi usando il web stesso — ogni cosa una risorsa con un indirizzo, pochi verbi universali per agire, ogni richiesta completa in sé, un linguaggio condiviso di risposte, e rappresentazioni scambiate in un formato comune, il JSON...

5 min
EP 009
REST non è l'unica via: i limiti, e le alternative

REST non è l'unica via: i limiti, e le alternative

La verità onesta: REST non è perfetto, ed è più uno stile libero che uno standard rigido, e va bene così...

5 min
EP 008
Un'API è un prodotto: progettarla per chi la userà

Un'API è un prodotto: progettarla per chi la userà

Dal meccanismo al mestiere: un'API non è solo un ponte tecnico, è un prodotto, e i suoi utenti sono altri programmatori, incluso te tra sei mesi...

5 min
EP 007
La cosa e la sua fotografia: risorse e rappresentazioni (e il JSON)

La cosa e la sua fotografia: risorse e rappresentazioni (e il JSON)

Una sottigliezza nascosta nel nome di REST: quando chiedi una cosa, non ricevi la cosa, ma una sua rappresentazione, una fotografia...

5 min
EP 006
Il linguaggio delle risposte: i codici di stato

Il linguaggio delle risposte: i codici di stato

L'altra metà del dialogo: la risposta, e come un servizio dice com'è andata...

4 min
EP 005
Ogni richiesta racconta tutto: l'assenza di memoria

Ogni richiesta racconta tutto: l'assenza di memoria

Una regola strana di REST: il server non tiene memoria di te tra una richiesta e l'altra, e ogni richiesta deve contenere tutto ciò che serve, da sola...

5 min
EP 004
Pochi verbi per tutto: l'interfaccia uniforme

Pochi verbi per tutto: l'interfaccia uniforme

L'idea più elegante di REST: come si agisce sulle cose...

5 min
EP 003
Ogni cosa ha un indirizzo: gli URL come posizione delle risorse

Ogni cosa ha un indirizzo: gli URL come posizione delle risorse

Se tutto è una risorsa, ogni risorsa ha bisogno di un indirizzo, e REST riusa gli stessi indirizzi del web, estendendoli dalle pagine a ogni cosa...

5 min
EP 002
Tutto è una risorsa: pensare per cose, non per azioni

Tutto è una risorsa: pensare per cose, non per azioni

Il cuore di REST: tutto è una risorsa...

5 min
EP 001
Cos'è un'API, e perché il web ne è pieno

Cos'è un'API, e perché il web ne è pieno

Saliamo dalla sala macchine (Redis, Kafka) alla porta d'ingresso: le API, il modo in cui i programmi si parlano...

4 min