Dans ce tutoriel je vous propose de parler un peu de REST. REST décrit une architecture de communication Client / Serveur. Très normalisée, il permet de créer une API qui fonctionne de manière uniforme et ce, peu importe la technologie utilisée sur le serveur (PHP, Ruby, Java...)
Le fonctionnement est caractérisé par 2 facteurs.
Le système de ressources
Le but de l'API sera de rendre accessible des ressources (resources en anglais) qui correspondent aux données de votre application (users, posts...)
Les entêtes (Request Method)
Plutôt que de nommer les différents endpoints de notre API avec des verbes (get_last_posts par exemple) REST propose d'utiliser les entêtes pour indiquer les actions à effectuer.
- GET : Récupération
- POST: Ajout
- PUT/PATCH: Modification
- DELETE: Suppression
Les URLs
La combinaison de ces 2 principes permettent de construire les URLs "REST" :
- /resources, GET, Récupère la liste des resources
- /resources/:id, GET, Récupère la resource selon l'ID
- /resources, POST, Créer une nouvelle resource
- /resources/:id, PUT/PATCH, Met à jour une resource
- /resources/:id, DELETE, Supprime une resource
