Technique & développement
API REST
Style d'architecture standard pour concevoir des API web, où l'on manipule des ressources via des requêtes HTTP simples et structurées.
Qu'est-ce qu'une API REST ?
Une API REST (REpresentational State Transfer) est une manière standardisée de concevoir des API web. C'est aujourd'hui le style le plus répandu pour faire communiquer deux logiciels sur internet : une application demande une donnée ou une action, le serveur répond, le tout via le protocole HTTP — le même que celui des sites web.
REST n'est pas une technologie, mais un ensemble de conventions qui rendent les échanges entre logiciels prévisibles, lisibles et faciles à intégrer.
Comment fonctionne une API REST ?
Le principe repose sur des ressources (un client, une facture, un produit), chacune accessible via une URL. On agit sur ces ressources avec les méthodes HTTP :
| Méthode | Action | Exemple |
|---|---|---|
GET |
Lire | Récupérer la liste des clients |
POST |
Créer | Ajouter un nouveau client |
PUT / PATCH |
Modifier | Mettre à jour un client |
DELETE |
Supprimer | Effacer un client |
Les données échangées sont le plus souvent au format JSON, lisible aussi bien par les machines que par les humains. Chaque réponse s'accompagne d'un code de statut (200 = succès, 404 = introuvable, etc.).
Pourquoi REST est-il si utilisé ?
- Simplicité : il s'appuie sur HTTP, déjà universel.
- Standardisation : des conventions claires que tout développeur comprend.
- Interopérabilité : n'importe quel langage ou plateforme peut consommer une API REST.
- Découplage : le frontend, le mobile et d'autres systèmes consomment la même API sans être liés au backend.
REST ou GraphQL ?
REST expose des points d'entrée fixes par ressource ; GraphQL permet au client de demander exactement les données dont il a besoin en une seule requête. GraphQL est puissant quand les besoins de données sont variables et complexes ; REST reste le choix par défaut, plus simple, pour la majorité des cas. Les deux peuvent coexister.
REST dans un projet sur-mesure
Une API REST bien conçue est la colonne vertébrale de l'intégration d'un logiciel sur-mesure : elle permet à votre outil de dialoguer avec votre CRM, votre facturation, votre site ou une application mobile. C'est ce qui rend un logiciel ouvert et connecté plutôt qu'isolé.
Questions fréquentes
REST et API, est-ce la même chose ? Non : REST est un style de conception d'API. Une API REST est une API qui suit les conventions REST. Voir API.
REST est-il sécurisé ? Oui, avec les bonnes pratiques : échanges chiffrés (HTTPS), authentification (clé d'API, token), et contrôle des droits d'accès.
Que veut dire « stateless » ? Une API REST est « sans état » : chaque requête contient toutes les informations nécessaires pour être traitée, sans que le serveur ait à se souvenir des échanges précédents. Cela facilite la fiabilité et la montée en charge.
