Cours complet sur les API REST

1. Qu’est-ce qu’une API REST ?

Une API REST (REpresentational State Transfer) est une interface de programmation d’application qui respecte les principes de l’architecture REST. Elle permet à deux applications de communiquer entre elles, souvent via internet.

Historique :

Avant les années 2000, le protocole SOAP (basé sur XML) dominait, mais il était lourd et complexe. REST, introduit par Roy Fielding en 2000, s’est imposé pour sa simplicité, sa légèreté et son efficacité.

À retenir :

REST est un style d’architecture logicielle.

Une API RESTful suit les principes REST pour l’échange de données.

2. Comment fonctionne une API REST ?

L’API REST repose sur un modèle client-serveur :

Le client (navigateur, application mobile…) envoie une requête à l’API.
L’API transmet la requête au serveur.
Le serveur traite la demande et renvoie la réponse au client via l’API.

Schéma de fonctionnement

sequenceDiagram
    participant Client
    participant API
    participant Serveur

    Client->>API: Envoie une requête (GET, POST…)
    API->>Serveur: Transmet la requête
    Serveur->>API: Renvoie la réponse (données)
    API->>Client: Transmet la réponse au client

Principales méthodes HTTP

Méthode	Action	Exemple d’utilisation
GET	Récupérer des données	Liste des produits
POST	Envoyer/ajouter des données	Créer un nouvel utilisateur
PUT	Mettre à jour des données	Modifier un profil
PATCH	Modifier partiellement une ressource	Changer un champ d’un profil
DELETE	Supprimer des données	Effacer un commentaire

Formats de données

JSON (léger, lisible, populaire)
XML (structuré, compatible avec RSS)
YAML, HTML (autres formats possibles)