Définition (pour un glossaire) — REST API
Une REST API (ou API REST) est une façon standardisée pour des applications de communiquer entre elles sur Internet. Plutôt que d’entrer dans des détails techniques, on peut la voir comme un langage commun que se parlent les programmes : on envoie des requêtes à des adresses web (URL) et on reçoit des données en retour, généralement au format JSON.
Principales caractéristiques simples à retenir :
– Ressources : chaque type de donnée (utilisateur, article, photo…) a sa propre adresse URL.
– Verbes HTTP : on utilise des actions standard du web (GET pour lire, POST pour créer, PUT/PATCH pour modifier, DELETE pour supprimer).
– Représentations : la même ressource peut être envoyée en JSON, XML, etc. — le format s’appelle la « représentation ».
– Sans état (stateless) : chaque requête contient tout ce qu’il faut pour être comprise (le serveur ne garde pas d’historique entre deux requêtes).
– Architecture, pas un protocole : REST décrit des règles et des bonnes pratiques, pas un logiciel spécifique.
Exemple simple : une requête GET vers https://api.exemple.com/users/42 renverra les informations (en JSON) de l’utilisateur numéro 42.
Pourquoi c’est utile : c’est simple, compatible avec le web, facile à utiliser depuis un navigateur, une application mobile ou un autre serveur, et permet de connecter des systèmes différents de façon claire et standardisée.
