REST API dans le protocole HTTP
En règle générale, lors de la création de sites web, seules les méthodes GET et POST sont utilisées pour obtenir, créer, modifier et supprimer des données, car elles sont bien prises en charge par les navigateurs et les serveurs. Il en va de même pour les API fournies par les sites. Il existe cependant des approches spécialisées qui standardisent les API pour le confort général des développeurs d'API ainsi que de ses utilisateurs.
L'une de ces approches est REST API (on dit souvent RESTful en utilisant ce mot comme un adjectif). La base de cette API repose sur l'utilisation extensive des méthodes du protocole HTTP. Dans cette approche, la méthode GET est utilisée pour récupérer des données, la méthode POST pour en créer, la méthode PUT pour les modifier, et la méthode DELETE pour les supprimer.
Par exemple, prenons une API manipulant des utilisateurs. Regardons à quoi ressembleraient les URL pour différentes actions.
Récupérer tous les utilisateurs :
GET http://api.loc/users/
Récupérer un utilisateur par son id :
GET http://api.loc/user/1/
Créer un utilisateur :
POST http://api.loc/user/
Modifier un utilisateur par son id :
PUT http://api.loc/user/1/
Supprimer un utilisateur par son id :
DELETE http://api.loc/user/1/
Supposons que vous ayez une API de produits pour une boutique en ligne. Décrivez les URL de la boutique de manière à ce que l'API devienne RESTful.
