API Storefront — afficher votre catalogue sur un autre site ou une application

L'API Storefront permet à un développeur d'afficher le catalogue de votre boutique sur un site ou une application qu'il construit lui-même (une boutique « headless »), tandis que vous continuez à tout gérer dans Ordexs. Elle lit ce que n'importe quel visiteur voit déjà sur votre boutique : produits, prix, collections, catégories, pages, politiques, avis, offres et prix de livraison, et elle peut calculer le prix d'un panier. Elle ne modifie jamais rien et n'affiche jamais les prix de revient, les codes-barres, les quantités en stock, les clients ni les commandes. Les commandes passées depuis un tel site le sont avec une clé API (voir la fiche sur les clés API).

Où. Paramètres → Développeurs → API Storefront. Elle est disponible sur tous les forfaits, y compris Try. La section affiche l'adresse API de votre boutique, avec un bouton de copie, à transmettre à votre développeur.

Jetons. Le site d'un développeur a besoin d'un jeton storefront (il commence par ordx_sf_). Appuyez sur Nouveau jeton, donnez-lui un nom que vous reconnaîtrez (par exemple le site auquel il est destiné) et choisissez où il peut être utilisé :

  • Sites listés — listez les adresses des sites, une par ligne (par exemple https://shop.example.com), jusqu'à 10. Les navigateurs sur tout autre site sont refusés. Laissez la liste vide pour n'utiliser le jeton que depuis des serveurs et des applications mobiles (affiché comme « Serveurs et applications seulement »).
  • Tous les sites — n'importe quel site peut l'utiliser, et cela compte dans vos limites.

Une boutique peut avoir 10 jetons actifs. Le propriétaire de la boutique et les administrateurs les créent, les renomment, les modifient et les révoquent ; les autres membres de l'équipe qui peuvent ouvrir les paramètres peuvent les voir.

Un jeton storefront n'est pas un secret. Il se trouve dans le code du site, où n'importe qui peut le lire, et il n'ouvre que ce que votre boutique montre déjà publiquement. C'est pourquoi le jeton complet reste visible dans la liste et peut être copié à nouveau à tout moment, contrairement à une clé API. Utilisez Sites listés pour qu'un autre site ne puisse pas l'emprunter.

Révocation. Appuyez sur le bouton de révocation et confirmez. Les sites qui utilisent le jeton cessent de fonctionner en une minute environ. La révocation est définitive ; créez un nouveau jeton si vous en avez de nouveau besoin. Afficher les jetons révoqués liste les anciens.

Ce qu'affiche la liste. Le nom de chaque jeton, le jeton lui-même, les sites autorisés à l'utiliser, sa dernière utilisation et le nombre de requêtes servies au cours des dernières 24 heures.

Limites. Chaque jeton traite jusqu'à 3 000 requêtes par minute, et chaque visiteur jusqu'à 180. Les réponses sont mises en cache et se mettent à jour dans les secondes qui suivent une modification faite dans le tableau de bord, si bien qu'un site très fréquenté ne ralentit pas votre boutique.

Votre propre boutique n'a pas besoin de jeton. Votre boutique Ordexs, et les scripts d'une boutique créée avec le créateur de boutique IA, lisent les mêmes données sur l'adresse de votre boutique sans jeton.

Les développeurs trouvent le guide complet, avec des exemples, sur ordexs.com/docs sous Storefront API.

Plus dans Développeurs

Besoin d'aide supplémentaire ?

Posez votre question à l'assistant depuis la barre de recherche de votre tableau de bord. Il répond à partir de ces mêmes guides, en français, en anglais ou en arabe, et peut effectuer des modifications pour vous. Vous pouvez aussi nous écrire : une personne vous répondra.