Chapitre 5 : Resources RESTful
Design de ressources RESTful
Bien nommer ses points d'accès (endpoints) est crucial pour la clarté et l'évolutivité de votre API.
Utilisez des Noms, pas des Verbes
L'URI doit représenter une ressource (un nom), pas une action (un verbe). L'action est portée par la méthode HTTP (GET, POST, etc.).
Mauvaise pratique
/getAllUsers/createUser/deleteAccount?id=12
Bonne pratique
GET /usersPOST /usersDELETE /users/12
Hiérarchie et Pluriel
Il est recommandé d'utiliser le pluriel pour les collections et de suivre la structure logique des données.
/authors: Liste tous les auteurs./authors/7: L'auteur numéro 7./authors/7/books: Tous les livres de l'auteur n°7./authors/7/books/102: Le livre 102 de l'auteur n°7.
Versioning (Gestion des versions)
Une API évolue. Pour ne pas casser les applications de vos clients, utilisez un numéro de version dans l'URL.
https://api.monsite.com/v1/users
Quand vous ferez des changements majeurs, vous pourrez créer /v2/users sans supprimer tout de suite la v1.
kebab-case (mots-separes-par-tirets) pour vos URI.
Quiz du chapitre 5
Ateliers pratiques & Projets
Testez vos compétences avec nos exercices guidés et le tuteur IA.
Ateliers pratiques & Corrigés détaillés
Ateliers pratiques & Corrigés
#1 — Comprendre les notions
Atelier #1Expliquez avec vos mots le concept central de ce chapitre.
Consulter la solution type du formateur
#2 — Application guidée
Atelier #2Reprenez l'exemple du cours et réalisez un cas pratique.
Consulter la solution type du formateur
#3 — Mini défi d'autonomie
Atelier #3Concevez une mini-solution liée à ce chapitre.