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
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...
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ì...
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...
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...
Il linguaggio delle risposte: i codici di stato
L'altra metà del dialogo: la risposta, e come un servizio dice com'è andata...
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...
Pochi verbi per tutto: l'interfaccia uniforme
L'idea più elegante di REST: come si agisce sulle cose...
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...
Tutto è una risorsa: pensare per cose, non per azioni
Il cuore di REST: tutto è una risorsa...
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...