1. Introduction

Bienvenue dans ce cours sur la création d'API Rest avec Symfony. Avant de rentrer dans le vif du sujet, faisons quelques rappels sur les API. On va voir dans ce chapitre : 

- les codes HTTP 

- les méthodes de requêtes HTTP

- les 6 contraintes de REST

- le modèle de Richardson

C'est parti 😊

 

Les codes HTTP 

Il existe de nombreaux codes HTTP, je ne vais citer que les principaux ici :

Code Message Signification
200 OK La requête a été traitée avec succès.
301 Moved Permanently Ressource déplacée de façon permanente.
302 Found Ressource déplacée de façon temporaire.
401 Unauthorized Une authentifiaction est nécessaire pour accéder à la ressource.
403 Forbidden Les droits d'accès du client ne permettent pas d'accéder à la ressource.
404 Not Found La ressource n'a pas été trouvée.
500 Internal Server Error Erreur interne du serveur.
503 Service Unavailable Service temporairement indisponible.
504 Gateway Time-out Le serveur a reçu une réponse invalide.

Si vous souhaitez retrouver la liste de tous les codes HTTP, suivez ce lien.

 

Les méthodes de requêtes HTTP

Là aussi, il existe aussi de nombreuses méthodes. Je vais en citer quelques-unes :

Nom Signification
GET Cette méthode est la plus courante, et permet de récupérer une ou plusieurs ressources.
POST Cette méthode permet de créer une nouvelle ressource.
PUT Cette méthode permet de remplacer une ressource existante.
PATCH Cette méthode permet de remplacer partiellement une ressource existante.
DELETE Cette méthode permet la suppression d'une ressource.

Vous pouvez retrouver la liste des méthodes à ce lien.

 

6 contraintes de REST

Voici la liste des contraintes de REST :

Client–serveur

Sans état

Avec mise en cache

En couches

Avec code à la demande (facultative)

À interface uniforme



Modèle de richardson

https://martinfowler.com/articles/richardsonMaturityModel.html