Approfondiamo cosa sia una REST API e come funziona, dato che stiamo per costruirne una. Comprendere questi concetti fondamentali fornirà una solida base per il resto del nostro progetto.

Piano

• Che cos'è una REST API?
• Principi chiave delle REST;
• Come operano le REST API.

Che cos'è una REST API?

REST, ovvero Representational State Transfer, è uno stile architetturale per la progettazione di applicazioni in rete. Le REST API sono un insieme di regole per la creazione e l'interazione con servizi web, facilitando lo scambio di dati e le operazioni tra sistemi software.

Principi Fondamentali di REST

Per comprendere l'essenza delle API REST, è fondamentale ricordare questi principi chiave:

• Statelessness (Assenza di Stato): In REST, ogni interazione tra client e server è autonoma. Tutte le informazioni necessarie devono essere incluse nella richiesta stessa;
• Resource-Centric (Centrato sulle Risorse): REST considera tutto come una risorsa, identificando in modo univoco ciascuna risorsa tramite un URI (Uniform Resource Identifier). Queste risorse interagiscono attraverso i metodi HTTP standard come GET, POST, PUT e DELETE;
• Representation (Rappresentazione): Le risorse in REST possono avere più rappresentazioni, come JSON o XML. Questa flessibilità consente ai client di scegliere il formato preferito per lo scambio dei dati.

Come Funzionano le API REST

Ora, esaminiamo più da vicino come operano le API REST. Il processo coinvolge diversi passaggi chiave:

1. Request (Richiesta): I client avviano le richieste fornendo tutti i dettagli necessari all'interno di ciascuna richiesta. Questo include il metodo HTTP, l'URI e i parametri o dati richiesti;
2. Resource (Risorsa): L'API elabora la richiesta in base all'URI univoco della risorsa. Questo URI funge da indirizzo per la risorsa richiesta;
3. HTTP Methods (Metodi HTTP): I metodi HTTP standard determinano il tipo di operazione da eseguire. Ad esempio, GET viene utilizzato per il recupero, POST per la creazione, PUT per l'aggiornamento e DELETE per la rimozione;
4. Response (Risposta): Dopo aver elaborato la richiesta, il server invia una risposta nel formato di rappresentazione scelto, tipicamente JSON o XML. Questa risposta contiene i dati richiesti o la conferma dell'azione eseguita;
5. Statelessness (Assenza di Stato): Le interazioni REST sono progettate per essere stateless, il che significa che nessun dato di sessione viene memorizzato tra le richieste. Ogni richiesta è indipendente e autosufficiente.