Qu'est-ce qu'une API REST ? La façon la plus courante dont les applications communiquent
📷 Rodrigo Santos · Pexels✦ Points clés
- REST est un style de conception d'API web basé sur HTTP et des ressources adressées par URL.
- Les quatre méthodes clés : GET pour lire, POST pour créer, PUT/PATCH pour modifier, DELETE pour supprimer.
- Les réponses sont souvent en JSON avec un code de statut indiquant le résultat.
- REST est sans état : chaque requête est indépendante et se suffit à elle-même.
Une API REST (Representational State Transfer) est un ensemble de règles convenues permettant à deux applications d'échanger des données via le web. Quand l'application météo de votre téléphone affiche la température, elle la demande généralement à un serveur distant via une API REST et reçoit la réponse dans un format structuré. L'idée : tout est traité comme une ressource avec une adresse claire (URL), par exemple /users/42 pour l'utilisateur numéro 42.
REST repose sur le protocole du web (HTTP) et utilise ses méthodes standard pour exprimer l'opération souhaitée sur une ressource. D'où sa simplicité et sa familiarité pour tout développeur web : le même mécanisme qu'un navigateur pour ouvrir une page.
🌐 Temps de téléchargement
Durée de téléchargement selon votre débit — instantané.
Le tableau ci-dessous montre les quatre méthodes clés :
| Méthode | But | Exemple | Sûre/idempotente |
|---|---|---|---|
| GET | Lire des données | Récupérer une liste de produits | Oui (ne change rien) |
| POST | Créer un élément | Ajouter un produit | Non |
| PUT / PATCH | Modifier un élément | Mettre à jour un prix | PUT idempotente |
| DELETE | Supprimer un élément | Supprimer un produit | Idempotente |
Après chaque requête, le serveur répond avec un code de statut à trois chiffres : 200 succès, 201 créé, 400 requête invalide, 401 non autorisé, 404 introuvable, 500 erreur serveur. Retenir ces codes courants fait gagner beaucoup de temps.
Un principe clé de REST est qu'il est sans état : le serveur ne se souvient pas de vos requêtes précédentes ; chaque requête doit donc porter tout ce dont elle a besoin (comme un jeton d'accès). Cela facilite la mise à l'échelle. La réponse arrive généralement en JSON, léger et lisible.
Concrètement : une requête GET https://api.example.com/products/10 signifie « donne-moi le produit numéro 10 », et le serveur répond 200 avec les données du produit en JSON. Si le produit n'existe pas, il répond 404. C'est ainsi que sont bâties la plupart des applications web et mobiles modernes.
En résumé : une API REST n'est pas une technologie complexe mais un accord élégant pour utiliser les outils web existants — URL, méthodes HTTP et codes de statut — afin d'échanger des données de façon uniforme.
Sources
Osama AbdelAal est le fondateur de Marifa, expert en marketing digital et entrepreneuriat et ambassadeur Hootsuite EMEA. Il supervise et révise le contenu éditorial de Marifa pour en garantir l’exactitude et la valeur.