Une API REST est un style courant d'API qui utilise des requêtes Web standard, comme GET pour lire et POST pour créer, afin de manipuler des données à des adresses Web précises.
Intégration · Révisé par Ray Rasouli
Questions sur : API REST
Des réponses simples, adaptées à votre situation.
Posez n'importe quelle question sur API REST. Par exemple, comment ça fonctionne dans vos outils actuels.
Un guide scénarisé pour l'instant. Il ne conserve pas ce que vous tapez.
REST est la façon la plus répandue dont les applications d'affaires modernes partagent des données. Chaque type de fiche, comme les commandes ou les clients, a sa propre adresse Web, et on utilise des verbes simples pour lire, créer, modifier ou supprimer. Les réponses reviennent habituellement en JSON, un format texte que les gens et les machines peuvent lire.
Si un détaillant veut que sa boutique en ligne crée des commandes dans son système comptable, un développeur peut envoyer une requête POST avec les détails de la commande à l'adresse des commandes du système comptable.
Comme REST suit les normes du Web, la plupart des outils de programmation et des plateformes d'intégration le prennent en charge d'emblée.
En pratique
Les erreurs ne sont pas gérées.
Une requête peut échouer pour plusieurs raisons, et les intégrations qui ne vérifient pas la réponse perdent des données sans bruit.
La pagination est ignorée.
Les grandes listes reviennent par pages, et un code qui lit seulement la première page manque la plupart des fiches.
Les nouvelles tentatives créent des doublons.
Renvoyer une requête de création après un délai dépassé peut créer deux commandes, sauf si l'API gère l'idempotence.
Les formats de champs diffèrent entre les systèmes.
Les dates, devises et unités reviennent dans des formats qu'il faut convertir avant que l'autre système les accepte.
Representational state transfer, ou transfert d'état représentationnel. En pratique, on l'utilise pour parler d'une API bâtie sur des requêtes et des adresses Web standard.
REST donne à chaque ressource sa propre adresse. GraphQL utilise une seule adresse où l'appelant demande exactement les champs qu'il veut en une seule requête.
Un appel découverte de 30 minutes avec Ray, puis une liste claire de ce qu'il faut corriger d'abord. Sans engagement.
Avec Ray Rasouli. Sans engagement.