Dal corso: Fondamenti di programmazione: API e servizi web

Panoramica di REST

- Potresti aver sentito il termine API RESTful e ti sei chiesto cosa significasse. REST è l'acronimo di Representational State Transfer. È un insieme di linee guida che gli sviluppatori di applicazioni usano per progettare le API. Per capire meglio come funziona un'API RESTful tra il client e il server, usiamo un esempio. Jane ha fame e si siede in un ristorante. Questo rappresenta un bisogno. Ha bisogno di cibo. Quindi Jane esamina il menu, che elenca tutte le opzioni che può ordinare. Il menu è l'API. Le API hanno una serie di opzioni che puoi ordinare e utilizzare. Ora Jane seleziona il suo ordine, vuole pollo alla parmigiana e lo dice al cameriere. L'ordinazione è la chiamata API. Sta inviando il messaggio di ciò che il cliente vuole che accada. La cucina poi cuoce il cibo. Questa è l'API che fa il lavoro o recupera i dati necessari. Infine, il cameriere consegna il cibo a Jane. Questa è la risposta dell'API al client. Ottiene ciò che ha ordinato. Ora ci sono quattro principi che le API seguono e esaminiamo ciascuno di essi. Quando usi le API, scoprirai che questi principi ti semplificheranno la vita. Innanzitutto, i dati e le funzionalità nell'API sono considerati risorse e identificati tramite qualcosa chiamato URI o Uniform Resource Identifier. Vi si accede tramite link web. In secondo luogo, le risorse vengono manipolate utilizzando un insieme fisso di operazioni. GET recupera una risorsa, POST ne crea una, usa PUT per aggiornare la risorsa e, naturalmente, DELETE la rimuoverà. In terzo luogo, le risorse possono essere rappresentate in più formati, come HTML, XML, testo normale e altri formati definiti da un tipo di supporto. Infine, la comunicazione tra il client e l'endpoint è senza stato, il che significa che il server non ricorderà né memorizzerà alcuno stato sul client che ha effettuato la chiamata. Per spiegare meglio come funzionano i principi apolidi, supponiamo che tu sia in fila nella tua caffetteria locale e ordini il tuo latte al tè chai preferito. Dopo aver pagato e ritirato il tuo drink, ti ricordi che formatti per ordinarne uno per il tuo amico. Quindi ti rimetti in fila e dici al cassiere che ne vorresti un altro. Il cassiere non ricorda il tuo ordine e devi dirle di nuovo la tua richiesta. In effetti, probabilmente sta servendo così tanti clienti, è impossibile per lei ricordare tutto ciò che tutti ordinano. I servizi Web sono allo stesso modo. Questi principi assicurano che le applicazioni RESTful siano semplici, leggere e veloci.

Contenuti