Un'API REST (nota anche come API RESTful) è un'interfaccia di programmazione dell'applicazione (API o API Web) conforme ai vincoli dello stile architettonico REST e consente l'interazione con i servizi Web RESTful. REST sta per Representational State Transfer ed è stato creato dallo scienziato informatico Roy Fielding.
Cos'è un'API
Un'API è un insieme di definizioni e protocolli per la creazione e l'integrazione di software applicativo. A volte è indicato come un contratto tra un fornitore di informazioni e un utente di informazioni, che stabilisce il contenuto richiesto dal consumatore (la chiamata) e il contenuto richiesto dal produttore (la risposta). Ad esempio, la progettazione dell'API per un servizio meteorologico potrebbe specificare che l'utente fornisce un codice postale e il produttore risponde con una risposta in 2 parti, la prima è alta temperatura e la seconda è bassa temperatura.
In altre parole, se desideri interagire con un computer o un sistema per recuperare informazioni o eseguire una funzione, un'API ti aiuta a comunicare ciò che desideri a quel sistema in modo che possa comprendere e soddisfare la richiesta.
Puoi pensare a un'API come a un mediatore tra utenti o clienti e le risorse o i servizi Web che desiderano ottenere. È anche un modo per un'organizzazione di condividere risorse e informazioni mantenendo la sicurezza, il controllo e l'autenticazione, che determina chi ha accesso a cosa.
Un altro vantaggio di un'API è che non è necessario conoscere i dettagli della memorizzazione nella cache: come viene recuperata la risorsa o da dove proviene.
Cos'è il RIPOSO
REST è un insieme di vincoli architetturali, non un protocollo o uno standard. Gli sviluppatori di API possono implementare REST in vari modi.
Quando una richiesta client viene effettuata tramite un'API RESTful, passa una rappresentazione dello stato della risorsa al richiedente o all'endpoint. Queste informazioni, o rappresentazioni, vengono fornite in uno dei diversi formati su HTTP: JSON (Javascript Object Notation), HTML, XLT, Python, PHP o testo normale. JSON è il formato di file più diffuso in generale perché, nonostante il nome, è indipendente dalla lingua ed è leggibile sia dall'uomo che dalle macchine.
Qualcos'altro da notare: le intestazioni e i parametri sono importanti anche nei metodi HTTP di una richiesta HTTP API RESTful in quanto contengono importanti informazioni identificative in termini di metadati della richiesta, autorizzazione, identificatore uniforme (URI), memorizzazione nella cache, cookie e altro. Ci sono intestazioni di richiesta e di risposta, ognuna con le proprie informazioni di connessione HTTP e codici di stato.
Affinché un'API sia considerata RESTful, deve soddisfare questi criteri:
- Un'architettura client-server composta da client, server e risorse, con richieste gestite su HTTP.
- Comunicazione client-server senza stato, il che significa che nessuna informazione sul client viene archiviata tra le richieste di ricezione e ogni richiesta è indipendente e non connessa.
- Memorizzazione nella cache dei dati che semplifica le interazioni client-server.
- Un'interfaccia uniforme tra i componenti in modo che le informazioni vengano trasferite in modo standard. Ciò richiede che:
- le risorse richieste sono identificabili e separate dalle rappresentazioni inviate al cliente.
- Le risorse possono essere manipolate dal cliente attraverso la rappresentazione che ricevono perché la rappresentazione contiene informazioni sufficienti per farlo.
- i messaggi autodescrittivi restituiti al client hanno informazioni sufficienti per descrivere come il client dovrebbe elaborarli.
- ipertesto/ipermedia è disponibile, il che significa che dopo l'accesso a una risorsa, il client dovrebbe essere in grado di utilizzare i collegamenti ipertestuali per trovare tutte le altre azioni attualmente disponibili che può eseguire.
- Un sistema a più livelli che organizza ogni tipo di server (responsabili della sicurezza, del bilanciamento del carico, ecc.) implica il recupero delle informazioni richieste in gerarchie, invisibili al cliente.
- Code on Demand (opzionale): la possibilità di inviare codice eseguibile dal server al client quando richiesto, estendendo le funzionalità del client.
Sebbene l'API REST abbia questi criteri da soddisfare, è comunque considerata più facile da usare rispetto a un protocollo prescritto come SOAP (Simple Object Access Protocol), che ha requisiti specifici come la messaggistica XML e la sicurezza integrata e la conformità delle transazioni che rendono più semplice uso lento e più pesante.
Al contrario, REST è un insieme di linee guida che possono essere implementate secondo necessità, rendendo le API REST più veloci e leggere, con una maggiore scalabilità, perfette per l'Internet of Things (IoT) e lo sviluppo di software per app mobili.
