Concevoir une bonne API REST

Ressources & verbes, codes de statut, nommage, pagination, erreurs et versioning : l'essentiel pour une API REST prévisible, documentable et durable.

Une requête, une réponse

Le client demande une action sur une ressource ; l'API répond avec un code de statut. L'URL nomme la ressource, le verbe porte l'action.

Du client à l'API, et retour : le verbe agit, le code répond
🔌 UN ÉCHANGE REST · le verbe agit, le code répond Client API navigateur / appli serveur de ressources POST /orders { … } 201 Created + Location FAMILLES DE CODES 2xx 4xx 5xx Succès Faute client Faute serveur la demande a réussi requête mal formée erreur côté API

L'URL nomme la ressource (/orders), le verbe porte l'action (POST crée), et le code dit le résultat (201 = créé, avec un en-tête Location vers la nouvelle ressource). Le 1ᵉʳ chiffre du code donne le sens : 2xx succès, 4xx faute du client, 5xx faute du serveur.

🎯 Testez-vous

Six questions pour vérifier que les conventions REST sont bien acquises.

Retour aux outils développeurs