Une API REST est une manière courante de concevoir une API web autour de ressources comme des utilisateurs, des exercices ou des commandes. Chaque ressource reçoit une URL, et des méthodes HTTP comme GET, POST, PATCH et DELETE indiquent au serveur ce que le client veut faire.

REST signifie Representational State Transfer. En pratique, un client envoie une requête HTTP, le serveur renvoie une représentation d’une ressource, et chaque requête doit être compréhensible à elle seule. Beaucoup d’API REST renvoient du JSON, mais le JSON à lui seul ne rend pas une API RESTful.

Signification d’une API REST : penser en ressources

La façon la plus rapide de comprendre REST est de penser en noms, pas en verbes.

Si votre système contient des exercices, des étudiants et des tentatives, ce sont des ressources possibles. Une API orientée ressources utilise souvent des URL comme /api/problems/42 ou /api/attempts/9001.

La méthode HTTP indique ensuite quel type d’opération a lieu :

  • GET lit une ressource
  • POST crée une nouvelle ressource
  • PUT remplace une ressource
  • PATCH met à jour une partie d’une ressource
  • DELETE supprime une ressource

C’est cette séparation qui rend REST facile à parcourir. L’URL dit sur quoi vous travaillez. La méthode dit ce que vous voulez faire.

Comment fonctionne une requête API REST

Dans un flux classique, un navigateur, une application mobile ou un autre service envoie une requête à un serveur. La requête comprend une URL, une méthode HTTP, des en-têtes facultatifs et parfois un corps.

Le serveur lit la requête, effectue l’action, puis renvoie une réponse. Cette réponse contient généralement un code d’état comme 200 OK, 201 Created ou 404 Not Found, ainsi que des données qui décrivent le résultat.

Une condition importante est l’absence d’état, ou statelessness. En REST, chaque requête doit contenir le contexte nécessaire à son traitement. Cela ne veut pas dire que le serveur ne stocke aucune donnée. Cela signifie que le serveur ne doit pas avoir besoin d’un état de conversation caché provenant de requêtes précédentes pour comprendre la requête actuelle.

Exemple d’API REST : une application d’entraînement en maths

Supposons qu’une application d’entraînement en maths stocke des exercices d’algèbre et les tentatives des élèves.

Pour lire l’exercice 4242, le client peut envoyer :

Besoin d'aide pour un problème ?

Envoyez votre question et obtenez une solution vérifiée, étape par étape, en quelques secondes.

Ouvrir GPAI Solver →