API Rest : qu'est-ce que c'est

Si vous travaillez dans le domaine de la technologie, du marketing numérique ou des produits, vous avez probablement entendu l'acronyme REST API. C’est l’épine dorsale de l’Internet moderne. Il s'agit de la manière dont Instagram communique avec le serveur, de la manière dont le site Web de voyage recherche des billets sur différentes compagnies aériennes et de la manière dont votre banque approuve un achat par carte.

Mais qu’est-ce que REST exactement ? Et pourquoi est-il devenu la norme mondiale ?

Dans cet article, nous allons démystifier le concept technique et expliquer clairement ce qu'est une API RESTful.

Que signifie l'acronyme ?

REST signifie Representational State Transfer. C'est un concept créé par Roy Fielding dans sa thèse de doctorat en 2000.

Ce n'est pas un logiciel, ni une bibliothèque. C'est un style d'architecture. Il s'agit d'un ensemble de règles et de restrictions qui, si elles sont respectées, permettent à différents systèmes de communiquer entre eux de manière efficace, évolutive et simple sur Internet.

Une API qui suit les règles REST est appelée RESTful.

Comment ça marche (l'analogie du Web)

REST fonctionne exactement comme la navigation Web que vous connaissez déjà. Lorsque vous accédez à un site Web, vous (Client) demandez une page au serveur. Le serveur vous donne une « représentation » de cette ressource (le HTML de la page).

Dans l'API REST, c'est la même chose, mais au lieu de HTML (pour que les humains puissent le lire), nous utilisons JSON (pour que les machines puissent le lire).

Verbes HTTP (Actions)

REST utilise les méthodes du protocole HTTP standard pour définir ce que vous souhaitez faire avec les données :

GET : Récupère les données. (Ex : GET /usuarios -> Donnez-moi la liste des utilisateurs).
POST : créez des données. (Ex : POST /usuarios -> Créer ce nouvel utilisateur).
PUT : Mettre à jour les données complètes. (Ex : PUT /usuarios/1 -> Remplacer l'utilisateur 1 par cette donnée).
DELETE : Supprimer les données. (Ex : DELETE /usuarios/1 -> Supprimer l'utilisateur 1).

C'est intuitif. Avant REST, nous utilisions des protocoles complexes (comme SOAP) où il fallait inventer des noms pour tout (getUserList, createNewUserXml). En REST, l'URL est le nom (/usuarios) et la méthode HTTP est le verbe (GET, POST).

Apatride

C'est la règle la plus importante. Le serveur ne stocke pas la mémoire de votre navigation passée. Chaque demande (demande) doit contenir TOUTES les informations nécessaires pour être traitée (telles que qui vous êtes, le jeton d'authentification, ce que vous souhaitez). Cela permet à l'API d'être très rapide et évolutive, car le serveur ne gaspille pas de mémoire pour stocker les « sessions ».

L'anatomie d'un appel REST

Imaginez que vous vouliez connaître la température du jour.

Point de terminaison (URL) : https://api.clima.com/v1/previsao
Méthode : GET
En-tête : Authorization: Bearer 12345 (Votre carte d'identité).
Corps : (Vide dans GET, mais dans POST, il contiendrait des données).

Réponse du serveur : le serveur renvoie un simple JSON avec l'état de l'opération ("succès") et les données demandées, par exemple une température de 22 degrés Celsius pour la ville de Curitiba. Il s'agit d'un package léger, lisible dans n'importe quelle langue, que l'application n'a qu'à interpréter et afficher à l'écran.

Pourquoi REST a-t-il gagné ?

Pourquoi n'utilisons-nous pas d'autres moyens ?

Simplicité : Utilise le protocole HTTP qui existe déjà partout. Tout navigateur ou langage de programmation comprend HTTP.
Séparation client-serveur : L'application (frontend) et le serveur (backend) sont complètement indépendants. Vous pouvez modifier le design de l'application sans casser le serveur, et vice versa, tant que le format JSON reste le même.
Cache : REST profite de la mise en cache Web. Si vous effectuez un GET /produtos, le navigateur ou le réseau peut enregistrer cette réponse pendant quelques minutes, enregistrant ainsi les données.

Conclusion

L'API REST est la lingua franca d'Internet. Comprendre ses principes (Ressources, Verbes HTTP, Sans état) est fondamental pour tout professionnel de la technologie.

Bien que des technologies plus récentes comme GraphQL et gRPC gagnent du terrain pour des cas spécifiques, REST reste la référence pour 90 % des intégrations Web en raison de sa simplicité et de sa robustesse universelle.