REST API nel protocollo HTTP
Di norma, durante la creazione di siti web per ottenere, creare, modificare e eliminare dati, vengono utilizzati solo i metodi GET e POST, poiché sono ben supportati dai browser e dai server. Lo stesso vale per le API fornite dai siti web. Esistono, tuttavia, approcci speciali che standardizzano le API per la comodità generale sia degli sviluppatori delle API, sia dei loro utenti.
Uno di questi approcci è REST API (spesso si dice RESTful usando questa parola come aggettivo). Alla base di questa API c'è l'ampio utilizzo dei metodi del protocollo HTTP. In questo approccio, il metodo GET viene utilizzato per recuperare dati, il metodo POST per creare, il metodo PUT per modificare e il metodo DELETE per eliminare.
Ad esempio, consideriamo una certa API che gestisce utenti. Diamo un'occhiata a come appariranno gli URL per varie azioni.
Recuperare tutti gli utenti:
GET http://api.loc/users/
Recuperare un utente tramite il suo id:
GET http://api.loc/user/1/
Creare un utente:
POST http://api.loc/user/
Modificare un utente tramite il suo id:
PUT http://api.loc/user/1/
Eliminare un utente tramite il suo id:
DELETE http://api.loc/user/1/
Supponiamo che tu abbia un API per i prodotti di un negozio online. Descrivi gli URL del negozio in modo che l'API diventi RESTful.
