API REST : définition simple
Une API REST est une API qui suit le style d’architecture REST : chaque information a une adresse web précise, et on la lit ou on la modifie avec les verbes standards du web (GET, POST, PUT, DELETE). C’est la forme d’API la plus répandue pour faire dialoguer un site, une application mobile et un logiciel.

À retenir
- REST est une manière de concevoir une API, pas un produit à acheter : deux API REST peuvent être très inégales en qualité.
- Une adresse désigne une chose (une commande, un client) et un verbe dit ce qu’on en fait : la lire, la créer, la modifier ou la supprimer.
- La réponse arrive presque toujours en JSON, accompagnée d’un code qui dit si tout s’est bien passé (200) ou non (404, 401, 500).
Une API REST pas à pas
Imaginez un classeur où chaque fiche a un numéro et une étiquette.
Pour consulter la fiche 1042, vous demandez la fiche 1042. Pour la corriger, vous la rendez modifiée. Une API REST fonctionne ainsi : trois éléments suffisent pour comprendre le principe.
Consulter puis modifier une commande
- L’adresse. Chaque ressource a une adresse stable, par exemple /commandes/1042 pour la commande numéro 1042. L’adresse désigne la chose, jamais l’action à mener.
- Un nom au pluriel : /commandes, /clients
- Un identifiant pour une fiche précise
- Une adresse lisible par un humain
- Le verbe. Le logiciel ajoute un verbe pour dire ce qu’il veut : GET pour lire, POST pour créer, PUT ou PATCH pour modifier, DELETE pour supprimer. Ces verbes sont ceux du web lui-même.
- GET : je consulte
- POST : j’ajoute une fiche
- PATCH ou DELETE : je corrige ou j’efface
- La réponse. Le serveur répond avec les données au format JSON et un code de statut : 200 si tout va bien, 404 si la fiche n’existe pas, 401 si l’identité n’est pas reconnue, 500 si le serveur a un problème.
- Données lisibles par toute application
- Un code qui dit ce qui s’est passé
- Une erreur reste explicite
Des API REST au quotidien
Presque toutes les fonctions d’un site ou d’une application qui se synchronise reposent sur quelques requêtes REST.
Voici des cas que rencontre une entreprise.
| Besoin | Requête REST | Ce que vous y gagnez |
|---|---|---|
| Afficher les produits d’une boutique | GET /produits renvoie le catalogue, filtrable par catégorie ou par prix. | Le site et l’application affichent exactement le même catalogue. |
| Enregistrer une commande | POST /commandes envoie le panier ; l’API renvoie le numéro de la commande créée. | La commande arrive dans votre logiciel de gestion sans ressaisie. |
| Changer un statut | PATCH /commandes/1042 passe la commande à « expédiée ». | Le client voit le bon statut dans son espace, sans appeler. |
| Libérer un créneau | DELETE /rendez-vous/58 supprime la réservation annulée. | L’agenda en ligne redevient disponible tout de suite. |
| Retrouver un client | GET /clients?ville=Avignon liste les clients d’une ville. | Un commercial filtre sa tournée depuis son téléphone. |
| Consulter ses factures | GET /clients/12/factures liste les factures d’un client. | L’espace client est alimenté par la facturation, sans export manuel. |
Les styles d’API comparés
REST n’est pas le seul style, mais c’est le plus courant.
Voici comment il se situe par rapport aux autres termes que vous entendrez, à commencer par l’API elle-même.
REST
Une adresse par ressource, des verbes standards, des réponses simples. C’est le choix par défaut pour un site, une application mobile ou un logiciel métier.
- Très répandu, bien documenté
- Facile à tester dans un navigateur
- Convient à la plupart des projets
GraphQL
Le logiciel décrit exactement les champs voulus dans une seule requête. Utile quand une application mobile doit économiser les données, au prix d’une mise en place plus technique. Voir GraphQL.
- Une requête pour plusieurs données
- Réponses allégées
- Plus de travail à la conception
SOAP
Un format plus ancien, très structuré, fréquent dans la banque, l’assurance et l’administration. On s’y branche surtout quand le système existe déjà.
- Format XML plus lourd
- Rare dans les nouveaux projets
- Contrats d’échange très stricts
Webhook
Ce n’est pas vous qui demandez : l’autre logiciel vous prévient quand un événement a lieu. Il complète souvent REST, comme l’explique la page webhook.
- Notification en temps réel
- Pas de vérification en boucle
- Complète une API REST
Une API REST bien faite
Si vous commandez ou si vous achetez une API, vous n’avez pas à lire le code.
Trois points suffisent pour juger sa qualité avant de signer.
Une documentation claire
Chaque adresse, chaque verbe et chaque champ sont décrits avec un exemple de requête et de réponse. Sans documentation, la moindre évolution devient une enquête.
- Exemples de requêtes et de réponses
- Liste des codes d’erreur
- Mise à jour à chaque évolution
Des accès maîtrisés
Chaque utilisateur ou chaque application possède sa propre clé ou son propre jeton, avec seulement les droits nécessaires. Les échanges passent par HTTPS, et les appels sont journalisés.
- Une clé par application
- Droits réduits au strict besoin
- Trace des appels conservée
Des versions et des erreurs claires
L’adresse porte un numéro de version, par exemple /v1/. Quand l’API évolue, les applications existantes continuent de fonctionner. Les erreurs expliquent ce qui n’a pas marché.
- /v1/ puis /v2/ sans casse
- Message d’erreur lisible
- Limite d’appels contre les abus
Questions fréquentes
Quelle différence entre une API et une API REST ?
API est le terme général : tout moyen prévu pour qu’un logiciel en utilise un autre. REST est une manière précise de concevoir cette API, avec une adresse par ressource et des verbes standards. Toutes les API REST sont des API, mais l’inverse n’est pas vrai : il existe aussi des API SOAP, GraphQL ou des webhooks.
REST et RESTful, c’est la même chose ?
Dans l’usage courant, oui. On dit qu’une API est « RESTful » quand elle respecte bien les principes de REST : adresses par ressource, verbes standards, échanges sans mémoire d’une requête à l’autre. Beaucoup d’API se disent REST sans suivre tous ces principes ; ce n’est pas grave tant qu’elles sont cohérentes et documentées.
Une API REST est-elle sécurisée ?
Elle l’est autant que sa conception. REST ne protège rien par lui-même : la sécurité vient du chiffrement HTTPS, de l’authentification (clé ou jeton), de droits limités pour chaque accès, de la validation des données reçues et d’une trace des appels. Une clé d’accès se traite comme un mot de passe et ne doit jamais figurer dans le code visible d’un site.
REST ou GraphQL : lequel choisir ?
Pour la grande majorité des projets d’entreprise, REST suffit et reste plus simple à maintenir. GraphQL devient intéressant quand de nombreux écrans différents, souvent mobiles, demandent des morceaux de données très variés. Le choix se fait pendant le cadrage, d’après vos écrans et vos outils, pas par effet de mode.
Combien coûte la création d’une API REST ?
Cela dépend du nombre de ressources à exposer, des règles métier, du niveau de sécurité et de la documentation attendue. Une API qui relaie deux ou trois données simples n’a rien à voir avec celle d’un logiciel complet. Elle se chiffre poste par poste dans un projet de logiciel sur mesure. Après un appel de 30 minutes, vous recevez un devis détaillé sous 24 h.
Faut-il une API REST pour une application mobile ?
Dans la plupart des cas, oui. L’application mobile n’accède pas directement à votre base de données : elle passe par une API qui contrôle ce qu’elle peut lire ou modifier. C’est aussi ce qui permet de garder le même back-end pour l’application, le site et, plus tard, un partenaire.
À lire aussi
Besoin d’une API REST ?
Le cadrage liste vos outils, les données à échanger et les droits de chaque accès avant tout chiffrage. Voici les prestations où une API REST fait le lien.

Logiciel sur mesure
Une API REST documentée pour relier votre logiciel métier à votre site, à votre comptabilité ou à vos partenaires.
- Cadrage de vos outils existants
- Documentation de l’API livrée
- Code source livré

Logiciel SaaS
Une plateforme dont les clients ou les partenaires se branchent par une API documentée.
- Accès par clé et par client
- Versions de l’API prévues
- Évolutions sans casse

Web app et PWA
Une application web qui lit et écrit ses données par l’API, utilisable sur téléphone comme sur ordinateur.
- Mêmes données partout
- Application installable
- Hébergement pris en charge

Application mobile
Une application iOS et Android synchronisée avec votre site grâce à la même API.
- Données partagées avec le site
- Maquettes validées avant le code
- Publication sur les deux stores




Skyward Resto


