L'API Lengow vous permet de récupérer les commandes passées sur les places de marché et de réaliser des actions sur ces commandes. L'API ne concerne pour le moment que les marketplaces et les commandes, pas les produits ni les catalogues.
Tout ce qu'il faut savoir sur l'API Lengow !
Démarrer facilement avec nos cas d'utilisation concrets et les concepts clés expliqués.
Veuillez noter que nous proposons un plugin pour se connecter à my.lengow.io que vous pouvez utiliser à la place de notre API si vous disposez d'un back-office sur PrestaShop, Magento, Shopify, Shopware ou WooCommerce.
Afin de commencer à vous connecter à notre API, assurez-vous de disposer d'un compte Lengow. Cela vous permettra de vous authentifier et de vous connecter à l'API.
L'API Lengow est une API de type REST qui vous permet de :
- de répertorier et de récupérer les commandes de votre compte
- d'exécuter des actions sur les commandes : acceptation, expédition, annulation et remboursement
- Afficher la liste complète des actions possibles sur les commandes, autorisées par chaque marketplace, à quel statut et avec quels paramètres obligatoires ou facultatifs et avec quels paramètres obligatoires ou optionnels
- Récupérer les documents de facturation
- Communiquer avec l'entrepôt de Zalando
Astuces Lengow :
Tout au long de ce guide, nous vous recommandons d'utiliser Postman pour vous aider à intégrer et tester notre API. Lengow ne fournit pas de support sur Postman.
Les répartiteurs de charge entrants ont un délai d'attente de 350 secondes pour la fonction Keep-Alive. Si une requête est plus longue, une erreur de connexion se produira dû au dépassement de cette limite.
Concepts clés
Avant de commencer, voici quelques concepts centraux de l'API :
- A.P.I
API est un acronyme pour Applications Programming Interface. Une API est donc une interface de programmation qui permet de se « brancher » sur une application pour échanger des données.
Elle fonctionne sur un principe d’entrées et de sorties c'est à dire, qu'on l'utilise pour envoyer des actions et récupérer des informations entre deux systèmes.
Elle va aussi poser un cadre, c'est à dire, définir les types d'appels et de requêtes qui peuvent être effectués, comment les passer, et le format attendu qui doit être utilisé pour que ça fonctionne.
- Access token (jeton d'accès)
Pour vous authentifier sur l'API, vous devez obtenir un jeton d'accès (token). C'est un bloc de caractères qui contient les informations d'identification de sécurité pour une session de connexion et qui identifie l'utilisateur (vous).
Exemple de jeton: "6b7280eb-e7d4-4b94-a829-7b3853a20126
- Authorization header (En-tête d'autorisation)
L'Authorization header contient vos informations d'authentification. Une fois que vous avez votre jeton d'accès, toutes vos demandes vers l'API auront besoin d'un Authorization header.
- Endpoint
L'emplacement, le point d'entrée vers un endroit précis de l'API, on l'utilise pour y envoyer une demande, récupérer des informations et effectuer des actions.
Exemple : /orders/ est le endpoint qui amène vers le listing commandes dans l'API
- Pagination
Ce paramètre vous permet de définir sur combien de pages vous souhaitez voir s'afficher les résultats de votre requête. Et de définir combien de résultats vous souhaitez par page(s).
Lorsqu'elle n'est pas définie, la valeur par défaut de la page est 1.
Exemple : /orders/?account_id=1&page=5&page_size=50
- Paramètres de requête (filtrage)
Avec l'utilisation de paramètres de requête, les utilisateurs peuvent définir des filtres supplémentaires qui peuvent limiter le nombre d'entités renvoyées dans la réponse.
Les utilisateurs peuvent éventuellement spécifier les paramètres de la requête et les combiner à volonté. Les paramètres de requête sont ajoutés à la fin d'un chemin de ressource.
Le premier paramètre de requête est préfixé par "?", Tous les paramètres de requête supplémentaires sont séparés par le symbole "&".
Exemple : /orders/?account_id=1&marketplace=menlook
- Les produits
Un produit est tout article qui peut être envoyé depuis Lengow vers un canal. Il est généralement défini par son EAN (code européen de numérotation des articles), ou par un identifiant unique que vous avez choisi et enrichi de descriptions, d'images et d'autres contenus.
- Commandes et articles de commande (orders, order items)
Lorsqu'un client achète un ou plusieurs articles sur un canal, une commande est créée (order). La commande contient un ou plusieurs articles de commande (order items). Chaque article de commande contient un identifiant unique, une quantité, un prix, une référence client, etc.
- Autres concepts et flux
Un envoi est créé lorsqu'un ou plusieurs articles de commande sont envoyés au client, un retour est créé lorsqu'un client souhaite retourner un article de commande et une annulation est utilisée pour annuler une commande ou un article de commande.
Retrouvez le processus complet ici.