Définition

REST

Définition

REST (Representational State Transfer) est un style d'architecture pour concevoir des services web qui utilise les protocoles et méthodes HTTP standards.

Principes REST :

  • Stateless : Chaque requête est indépendante
  • Client-Serveur : Séparation claire des responsabilités
  • Cacheable : Les réponses peuvent être mises en cache
  • Interface uniforme : Utilisation des méthodes HTTP
  • Système en couches : Architecture modulaire

Méthodes HTTP :

  • GET : Récupérer des données
  • POST : Créer de nouvelles ressources
  • PUT : Mettre à jour complètement
  • PATCH : Mise à jour partielle
  • DELETE : Supprimer des ressources

Structure d'URL REST :

GET    /api/articles          # Liste des articles
GET    /api/articles/123      # Article spécifique
POST   /api/articles          # Créer un article
PUT    /api/articles/123      # Modifier un article
DELETE /api/articles/123      # Supprimer un article

Codes de réponse HTTP :

  • 200 : Succès
  • 201 : Créé
  • 400 : Mauvaise requête
  • 401 : Non autorisé
  • 404 : Non trouvé
  • 500 : Erreur serveur

Exemple d'usage

L'API REST de WordPress permet de récupérer les articles avec GET /wp-json/wp/v2/posts ou de créer un nouvel article avec POST /wp-json/wp/v2/posts.