REST API
REpresentational State Transfer Termine introdotto nel 2000 nella tesi di dottorato di Roy Fielding (uno degli autori del protocollo HTTP) Il paradigma REST nasce come astrazione di alcune delle caratteristiche fondamentali di HTTP che lo hanno reso diffuso e hanno permesso di usarlo come base per servizi e protocolli di più alto livello RESTful Web service sono quei servizi basati sul Web che rispettano i vincoli del paradigma REST
REpresentational State Transfer HTTP è il protocollo di comunicazione Ogni risorsa è identificata da un URI Base URI (es: Le risorse sono rappresentate in formati interoperabili (i più comuni: HTML, JSON, XML) Metodi PUT, GET, POST, DELETE per effettuare le 4 manipolazioni fondamentali su ogni risorsa: create, read, update, delete (CRUD) Per RESTful Web service si intende una API Web aderente al paradigma REST:
Collections GET: Restituisce l’elenco di URI dei membri della collection PUT: Sostituisce l’intera collezione con una differente specificata in input POST: Inserisce un nuovo item nella collection. L’URI del nuovo elemento è assegnato automaticamente ed inserito nel body della risposta DELETE: Elimina l’intera collection Ogni lista di elementi è caratterizzata da un’URI ( ed i metodi di utilizzo comune sono:
Item GET: Restituisce le informazioni relative all’oggetto identificato dall’URI, nel formato concordato ed utilizzando un Internet media type valido PUT: Sostituisce l’elemento corrente o, nel caso non esista, lo crea POST: Non sempre utilizzato. Assegna all’oggetto un nuovo valore all’elemento DELETE: Elimina l’item dalla collection Ogni elemento è caratterizzato da un’URI ( ed i metodi di utilizzo comune sono: