Documentation API
Comment utiliser l'API Xoopar
Réponses aux questions que nous recevons le plus souvent de la part des clients qui se connectent au catalogue produits de Xoopar via l'API.
Il s'agit d'une passerelle sécurisée qui vous permet de récupérer directement le catalogue produits de Xoopar dans vos propres systèmes — votre site e-commerce, ERP ou PIM.
Contactez votre interlocuteur commercial Xoopar. Il créera votre compte API et vous enverra un identifiant et un mot de passe. Il n'existe pas d'inscription en libre-service — chaque compte est configuré de notre côté pour vous renvoyer dès le départ les bons prix et la bonne langue.
Chaque requête utilise l'authentification HTTP Basic — la méthode de connexion standard prise en charge par pratiquement tous les outils d'intégration, connecteurs ERP et langages de programmation. Vous envoyez votre identifiant et votre mot de passe à chaque requête ; il n'y a pas d'étape de connexion séparée, de session ou de jeton à gérer.
Deux possibilités, selon vos besoins :
- Le catalogue complet — tous les produits disponibles pour votre compte, renvoyés en une seule réponse. La Middleware gère toute la pagination de notre côté, vous n'avez donc pas besoin de multiplier les requêtes.
- Un seul produit — un article recherché par son code produit. Pratique pour vérifier ou actualiser un produit à la fois.
Uniquement les prix associés à votre compte. Chaque client dispose de son propre prix dédié dans notre catalogue, et l'API filtre automatiquement les prix de tous les autres clients avant que les données ne vous parviennent.
Les images et fichiers sont fournis via des liens plutôt que de pointer vers nos systèmes internes. Vous pouvez les télécharger ou intégrer directement les liens dans votre site ou ERP.
Chaque appel au endpoint catalogue interroge notre système produits en temps réel : les données renvoyées sont donc toujours à jour au moment de votre requête. Aucune limite de requêtes n'est appliquée aujourd'hui, mais comme une requête sur le catalogue complet récupère et retraite l'ensemble des produits à chaque fois, nous recommandons d'interroger l'API une à deux fois par jour plutôt qu'en continu.
Le endpoint catalogue complet renvoie toujours l'ensemble des produits en une seule réponse. Il n'y a rien de plus à implémenter de votre côté à mesure que le catalogue grandit.
Oui — les niveaux de stock sont inclus directement dans les données produit, aucun endpoint séparé n'est nécessaire.
Les noms et valeurs des champs sont traduits dans votre langue, la plupart des champs sont donc explicites tels que renvoyés (par exemple, un attribut de type d'impression ou NFC/magnétique affichera un libellé lisible plutôt qu'un code interne). Un document de référence détaillant chaque champ est en cours de préparation — nous vous le communiquerons dès qu'il sera prêt.
Aujourd'hui, les prix sont renvoyés uniquement en EUR. La prise en charge des prix en GBP est en cours de développement — nous vous préviendrons dès qu'elle sera disponible.
Quelques détails pratiques à transmettre à votre développeur ou intégrateur :
- Tous les endpoints requièrent une authentification HTTP Basic et renvoient du JSON.
GET /api/products— catalogue complet, déjà paginé côté serveur pour vous.GET /api/products/{code}— un seul produit, recherché par son code.GET /api/media-files/{code}— télécharge une image ou un fichier produit via le proxy.