Ciao, e benvenuto nella terza puntata della quarantatreesima stagione. Nella scorsa puntata abbiamo scoperto che in REST tutto è una risorsa, una cosa. Oggi rispondiamo alla domanda che nasce subito dopo: se tutto è una cosa, come faccio a puntare a una cosa precisa? Come dico esattamente quale utente, quale ordine voglio? La risposta è: con un indirizzo. E qui REST fa una delle sue mosse più belle: riusa gli stessi indirizzi del web, quelli delle pagine. Oggi capiamo gli indirizzi delle risorse.
Partiamo dagli indirizzi che già conosci, perché sono il punto di partenza. Ogni pagina del web ha un indirizzo, quello che scrivi nella barra in alto o che si nasconde dietro un link. È l'indirizzo della pagina: lo digiti, e arrivi lì. Ecco, REST prende quest'idea, così familiare, e la estende: se ogni pagina ha il suo indirizzo, allora anche ogni risorsa, ogni cosa, avrà il suo indirizzo. Non solo le pagine da leggere, ma ogni utente, ogni ordine, ogni prodotto del servizio ha un proprio indirizzo con cui puntarci. È la stessa idea del web, applicata alle cose invece che alle pagine.
Voglio mostrarti come sono fatti questi indirizzi, perché la loro forma è illuminante. Gli indirizzi delle risorse hanno una struttura ordinata, gerarchica, leggibile. C'è un indirizzo che rappresenta tutti gli utenti, l'insieme. Sotto di esso, un indirizzo più specifico rappresenta un singolo utente preciso. E sotto ancora, un indirizzo rappresenta gli ordini di quel particolare utente. È come un percorso che si restringe: dagli utenti, a un utente, ai suoi ordini. Ogni pezzo dell'indirizzo aggiunge precisione, restringendo il campo, esattamente come un percorso di cartelle, o come un indirizzo postale che va dalla città, alla via, al numero civico.
Voglio farti apprezzare la magia della prevedibilità, perché è il vero regalo. Quando gli indirizzi sono organizzati così, con logica, succede una cosa preziosa: puoi indovinarli. Se sai che gli utenti stanno a un certo indirizzo, e che un singolo utente sta sotto di esso, allora puoi immaginare, senza che nessuno te lo dica, dove staranno gli ordini di quell'utente. La struttura logica ti permette di prevedere dove vive ciò che cerchi. È come muoverti in una città ben progettata, a scacchiera: capito lo schema, sai orientarti anche in quartieri che non hai mai visto. Un'API con indirizzi logici è una città ordinata; una con indirizzi arbitrari è un labirinto in cui ti perdi.
Voglio darti l'immagine che rende chiara questa idea, perché la senti tua. Pensa agli indirizzi postali. Da un indirizzo, città, via, numero, puoi trovare qualsiasi edificio del mondo, anche uno che non hai mai visto, perché il sistema è logico e universale. E se conosci lo schema di una città, puoi persino indovinare dove si trovi un certo numero civico su una via, senza andarci. Gli indirizzi delle risorse in REST funzionano così: un sistema logico di posizioni, da cui puoi raggiungere ogni cosa, e spesso persino indovinare dov'è. La leggibilità dell'indirizzo non è un vezzo: è ciò che rende l'API navigabile con la ragione, invece che a memoria.
Voglio farti notare quanto sia profonda questa idea del web, perché la diamo per scontata. Dare a ogni cosa un indirizzo chiaro e stabile è una delle intuizioni più potenti del web, e la diamo troppo per scontata. Il fatto che qualsiasi cosa, una pagina, un'immagine, un documento, abbia un indirizzo unico con cui raggiungerla e a cui puntare, è ciò che ha reso il web una rete navigabile, e non un mucchio di isole scollegate. REST estende questa intuizione dalle pagine a ogni cosa che un servizio conosce: rende indirizzabile tutto. E ciò che è indirizzabile è raggiungibile, collegabile, condivisibile. L'indirizzo trasforma una cosa da segreto interno a punto pubblico a cui chiunque può puntare.
Voglio trarre la lezione generale, perché va oltre REST. Ecco una verità da portare con te: rendere le cose indirizzabili, dare a ognuna una posizione chiara e stabile con cui raggiungerla, è un modo potente di dare ordine a un sistema. Quando ogni cosa ha il suo posto, e i posti seguono una logica, il sistema diventa navigabile, prevedibile, componibile. Vale per gli indirizzi web, ma è un principio generale: la struttura logica di dove vivono le cose è metà della loro usabilità. Un buon sistema di indirizzi non solo ti dice dove sono le cose: ti permette di ragionarci sopra, di indovinare, di orientarti senza mappa.
Per oggi ci fermiamo qui. Se in REST tutto è una risorsa, ogni risorsa ha bisogno di un indirizzo per essere raggiunta, e REST riusa gli stessi indirizzi del web, quelli delle pagine, estendendoli dalle pagine a ogni cosa. Questi indirizzi hanno una struttura gerarchica e leggibile, che si restringe dagli insiemi ai singoli: dagli utenti, a un utente, ai suoi ordini, come un indirizzo postale. E la loro logica regala la prevedibilità: puoi indovinare dove vivono le cose, come orientarti in una città ben progettata. Rendere tutto indirizzabile è una delle intuizioni più profonde del web. La lezione: dare a ogni cosa una posizione chiara e logica è metà della sua usabilità. Nella prossima puntata vediamo come si agisce sulle risorse: pochi verbi per tutto. Nelle note trovi qualche spunto. Se ti è utile, condividila. Grazie per l'ascolto, e ci sentiamo alla prossima.