Qu'est-ce qu'une API REST ?

Une API REST est une interface qui expose des ressources via HTTP en utilisant un petit ensemble de verbes et des motifs d'URL prévisibles. REST, pour Representational State Transfer, est un style architectural plutôt qu'un protocole strict, mais l'usage courant de GET, POST, PUT, PATCH et DELETE sur des URL de ressources est devenu la façon par défaut d'intégrer les services web.

Définition

Dans une conception REST typique, chaque ressource a sa propre URL, et les opérations sur la ressource correspondent aux verbes HTTP. Un produit peut se trouver à /products/123, récupérable avec GET, modifiable avec PATCH et supprimable avec DELETE. Les réponses sont généralement en JSON, les codes de statut signalent les résultats, et les en-têtes portent des métadonnées comme les directives de cache et les jetons d'authentification.

Pourquoi c'est important

Les API REST sont la lingua franca des stacks de commerce modernes. Les systèmes PIM, les OMS, les prestataires de paiement, les moteurs de recherche et les plateformes de contenu exposent des points d'accès REST que les vitrines et les couches d'intégration consomment. Leur simplicité, leur large support d'outils et leur sémantique HTTP explicite les rendent bien adaptées aux intégrations publiques.

REST vs. GraphQL

REST excelle dans les interactions claires, orientées ressources, et profite du cache HTTP natif. GraphQL excelle dans les lectures flexibles où le client décide de la forme de la réponse. En pratique, la plupart des stacks de commerce composable combinent les deux : REST pour l'intégration service à service et les webhooks, GraphQL ou BFF pour le frontend. Le choix dépend des compétences de l'équipe, de l'écosystème et de la prévisibilité des besoins du client.

Articles liés

Découvrir Composable Digital Experience Platform · Composable Headless Frontend.