1. Accueil
  2. About our catalog API

 

Pour qui est destinée l'API catalogue?  

Ce service n'est disponible que pour les clients agrée d'ascendeo. Si vous souhaitez devenir partenaire nous vous invitons à puis de suivre le processus d'inscription. 

Principalement déstinée au client d'ascendeo possédant un site ecommerce, notre API peut également être utile si vous souhaitez alimenter votre ERP en information produit.

Sachez que si le service n'est pas complexe il nécessite toutefois des connaissance technique lié à l'usage d'API.  Si vous avez juste besoin d'un fichier CSV, nous vous conseillons de suivre notre guide pas à pas car l'api peux vous le fournir 

 

Qu'est ce que l'API catalogue d'Ascendeo 

 

Une API  (Application Programming Interface) est un service informatique permettant a 2 systeme informatique d'échanger des informations de maniere structurée. 

Dans le cadre d'un site ecommerce comme ascendeo.fr , l'API est une interface qui permettra à votre équipe IT de récupérer les informations  du catalogue dans le format  de leur choix. 

Si vous avez de la demande sur des produit Omuvit ou So seven mais êtes en rupture de stock il peut etre interessant pour vous de savoir quelle est le stock en temps réel chez Ascendeo pour pouvoir continuer de prendre des commandes sur votre prorpre site. 

En parrallele de cela, la récupération des images produits peut consommer du temps et donc de l'argent à vos équipe web, mais avec une API ces dernieres pourront récuperer automatiquement les dernieres images disponible par références, limitant ainsi les risques d'erreur et le temps nécessaire à l'upload sur votre propre site. 

En résumé, l'API ascendeo a été conçu pour vous simplifier la vie et vous faire gagner du temps sur toutes les problématiques que vous pouvez rencontrer au quotidien sur la gestion de votre catalogue. 

 

Comment se connecter à l'API. 

Chaque client trouveras dans son compte une clé d'API  qui lui est prorpre. On parle parfois de jeton d'authentification (authentification_token). C'est la clé qui vous permettra d'utiliser l'API . 

Pour la retrouver rendez vous dans 

Votre compte  > Information du compte

en bas de la liste d'information vous trouverez votre clé d'API 

Votre compte - clé d'api ascendeo

 

Cette information est primordiale car sans elle vous ne pourrez pas envoyé de requête à notre API. 

 

Quelles informations puis je obtenir au travers de l'API

Vous recevrez systématiquement des informations de bases en réponse cependant un certain nombre de parametre vous permettront d'obtenir des informations nécessaires (notamment logistique)

La liste des attributs fournis par défaut est la suivante 

idproduct un id unique par référente
reference SKU 
ean le code EAN du produit
name Le nom du produit
product_type Le type / la catégories principale du produit.
brand la marque du produit 
stock la disponibilité du produit (mis à  jour toutes les 10 minutes) 
weight Le poids du produit avec packaging
short_description short description of the product
compatible_models Other models that are compatible 
image Une image au dimension de 300x300 pixel 
image_thumbnail Une image miniature de 90x90 pixel 
price_without_vat Prix HT du produit
hs_code HS Code
country_of_origin Country of origin
category_lv_1 Category of level 1
category_lv_2 Category of level 2
category_lv_3 Category of level 3
category_lv_4 Category of level 4
category_lv_5 Category of level 5

 

 

Paramètre de requêtes de l'API

Tous les parametre de requete viennent s'ajouter à l'url de base de l' API  : 

https://api.ascendeo.fr/Products/get/?version=3 

 

Paramètre de requête de l'API Obligatoire Fonction
authentification_token Obligatoire votre clé d'API qui
return_format Optionnel pour spécifier le format de réponse
product_reference[] Optionnel Pour filtrer votre requête sur une seul référence / SKU

 

authentification_token (aussi appelé clé d'Api) 

C'est  un paramètre obligatoire pour pouvoir interrogé le service d'API, cette infomation est propre à chaque client et est disponible dans votre compte. 

Si par exemple votre clé d'API ressemblait à cela "123myapikey" 

L'url de  l'API sera la suivante

https://api.ascendeo.fr/Products/get/?version=3&authentification_token=123myapikey

 

 

return_format

Nous acceptons les demande de format suivants : 

  • xml 
  • csv
  • json

Par défaut l'API envoie des réponses formaté au en Json, mais si vous préféré le XML ou le CSV il vous faudra le précisé. Par exemple pour du  XML : 

https://api.ascendeo.fr/Products/get/?version=3&authentification_token=123myapikey&return_format=xml

 

product_reference[]

C'est un parametre optionel  qui vous permet de récuperer les infos catalog d'un produit spécifique

Si votre systeme informatique a besoin d'un tarif ou d'une disponibilité sur un article ABC1234 en particulier, il n'est pas forcement économique pour vous de réintégré l'intégralité du catalogue. 

Par conséquent vous pouvez envoyer une demande à l'api pour obtenir les informations uniquement sur ce produit ABC1234 en ajoutant à votre requete  &product_reference[]=ABC1234

https://api.ascendeo.fr/Products/get/?version=3&authentification_token=123myapikey&return_format=xml&product_reference[]=ABC1234​

 

Des questions un besoin de support technique ? écrivez nous  à  ea@ascendeo.com