Qu’est-ce que le REPOS?
De nombreux services accessibles au public exposent une API REST qui permet un large éventail d’applications, des interfaces utilisateur Web à l’intégration et à la synchronisation du système principal. Alors, qu’est-ce que REST exactement et qu’est-ce qui rend une API RESTful?,
REST – REpresentational State Transfer
Techniquement, REST signifie REpresentational State Transfer (ce n’est donc pas un acronyme parfait), et signifie essentiellement qu’il s’agit d’une architecture destinée à transférer une représentation de données ou d’état de serveur entre un client et un serveur.
Il y a quelques critères détaillés qui sont considérés nécessaires pour qu’une API soit RESTful, mais le plus important est que l’API soit:
- Stateless
Cela signifie qu’il n’y a pas de session nécessaire entre un client et un serveur., Les données reçues du serveur peuvent être utilisées par le client indépendamment. Cela permet des opérations courtes et discrètes, et même la mise en cache hors ligne des données. Cela rend REST un ajustement naturel pour les opérations HTTP dans lesquelles les requêtes sont destinées à être singulières et de courte durée.
- Uniform
Les API REST sont censées être auto-descriptives, uniformes dans leur définition, et chaque opération séparée par un point de terminaison ou une URL différente. En termes pratiques, la plupart des API REST implémentent des opérations CRUD classiques (Créer, Lire, Mettre à jour, Supprimer) sur un modèle de données., Cette uniformité permet aux développeurs d’apprendre facilement le modèle d’utilisation de chaque API.
Alors, à quoi ressemble une API REST?
Parce qu’il est censé être représentatif, commençons par le modèle de données qu’il est censé représenter. Par exemple, si nous avons une application de commerce en ligne, nous voudrions définir les opérations de gestion des produits dans notre catalogue, centrées sur le modèle de produit.
Chacune de ces opérations serait liée à une combinaison d’une URL et d’un verbe HTTP., Pour passer en revue, il existe de nombreux verbes HTTP, mais la plupart des développements Web utilisent uniquement les verbes GET et POST pour demander une URL ou publier des données de formulaire, respectivement. Mais REST utilise plus de verbes HTTP pour signaler au serveur quel type d’opération le client effectue.
Voici une liste simplifiée d’URL combinées avec le verbe HTTP que nous utiliserions pour exposer l’API complète pour la gestion d’un catalogue de produits:
Les opérations et les URL ci-dessus ne sont que les opérations de base, Les API REST peuvent également prendre en charge des opérations très spécifiques ou des opérations hiérarchiques. Par exemple, si vous vouliez envoyer un signal au serveur pour réorganiser un approvisionnement de produits, vous pouvez exposer une URL comme ceci:
/produits/{id}/réorganiser | POST | Signal au serveur que vous souhaitez réorganiser les quantités d’un produit {id}. Le corps du message peut être vide ou contenir un modèle de données utilisé pour des instructions détaillées sur l’opération de réorganisation., |
Ou, si vous voulez plonger dans le catalogue des produits et l’exécution d’une requête pour renvoyer une liste de toutes les commandes pour un produit donné, l’API pourrait exposer une opération comme celle-ci:
/produits/{id}/commandes | GET | etant Donné {id} pour un produit, le retour de tous ordres., |
a l’Inverse, vous pouvez exposer un ordre centrée sur le point de terminaison qui vous permet de lister tous les produits dans l’ordre:
/commandes/{id}/produits | GET | Donné l’ordre {id} retour de tous les produits dans l’ordre. |
Ce que fait le serveur de données ressembler?,
Bien qu’il n’y ait pas d’exigence stricte quant au type de données qu’une API REST utilise ou renvoie, il est devenu un standard de facto pour les API REST basées sur le Web d’utiliser JSON comme définition de données.
En effet, JSON est un format natif que tous les navigateurs modernes peuvent utiliser pour représenter des objets hiérarchiques. Pour plus d’informations sur JSON, lisez notre article Qu’est-ce que JSON?
Pour en savoir plus sur nos produits, communiquez avec votre représentant des ventes OAS aux États-Unis au numéro sans frais 1-800-533-4994 ou pour toute demande internationale, composez le 1-303-679-0898.