Qu'est-ce qu'une API REST ?

REST API est un style architectural, et non une norme, pour construire des systèmes distribués. Il repose sur des principes tels que l'absence d'état, l'architecture client-serveur et l'utilisation de méthodes HTTP standard (GET, POST, PUT, DELETE, PATCH) pour les opérations sur les ressources.

Principes clés de REST:

• Sans état (stateless): Le serveur ne stocke pas d'informations sur l'état du client entre les requêtes. Chaque requête contient toutes les informations nécessaires à son traitement.
• Client-Serveur: Séparation claire entre le client et le serveur. Chacun peut évoluer indépendamment.
• Cacheable: Les réponses peuvent être marquées comme cacheables ou non, ce qui améliore la performance.
• Système en couches: Le client ne peut pas savoir s'il est connecté directement au serveur ou via des couches intermédiaires.
• Interface uniforme: Moyens standardisés d'interagir avec les ressources. Inclut:
  • Identification des ressources (URI)
  • Manipulation des ressources via des représentations
  • Messages auto-descriptifs
  • Hypermedia comme moteur de l'état de l'application (HATEOAS) - l'état de l'application est géré via des hyperliens.

Exemple d'utilisation des méthodes HTTP standard:

Méthode HTTP	Action sur la ressource (par exemple, /users)	Description
GET	/users ou /users/{id}	Obtenir la liste des utilisateurs ou un utilisateur spécifique.
POST	/users	Créer un nouvel utilisateur.
PUT	/users/{id}	Mise à jour complète des données de l'utilisateur par son ID.
PATCH	/users/{id}	Mise à jour partielle des données de l'utilisateur par son ID.
DELETE	/users/{id}	Supprimer l'utilisateur par son ID.

REST API est utilisé pour l'interaction entre différents systèmes et applications, par exemple entre le frontend et le backend.