Qu'est-ce qu'une intégration API et qu'apporte-t-elle à votre boutique en ligne ?

Qu'est-ce qu'une API et que fait une intégration API ?

Une API est un ensemble de règles qui permet à un logiciel de communiquer avec un autre logiciel, au lieu qu'une personne clique sur un écran. Voyez-la comme le guichet d'un système : vous demandez quelque chose sous une forme fixe et vous recevez une réponse sous une forme fixe ¹. Une intégration API utilise ce guichet pour faire travailler deux systèmes ensemble.

Pour une boutique en ligne, il s'agit généralement de quatre types de données :

• Stock. Une vente dans un système diminue la quantité dans l'autre. Lisez aussi comment synchroniser les stocks entre les canaux.
• Prix. Un changement de prix à un endroit arrive partout.
• Données produit. Titres, descriptions, photos et attributs passent de la source aux canaux.
• Commandes. Une commande arrive là où elle est traitée, et le statut ou le numéro de suivi revient.

C'est le même objectif que pour toute connexion de boutique en ligne. La différence tient à la façon dont la connexion est établie, et c'est l'objet de la suite.

Push et pull en termes simples

Un système peut demander s'il y a du nouveau (pull, ou polling), par exemple toutes les dix minutes. Il peut aussi être prévenu dès qu'il se passe quelque chose (push). Ce signal s'appelle souvent un webhook : le système envoie lui-même un message à une adresse que vous indiquez ³. Demander est simple, mais vous avez toujours un peu de retard et vous posez souvent la question pour rien. Être prévenu est plus rapide, mais votre côté doit pouvoir recevoir et traiter le message. Beaucoup d'intégrations utilisent les deux.

API, plugin, import CSV ou connecteur prêt à l'emploi ?

Les quatre transportent des données de A vers B. Elles diffèrent par la rapidité, la flexibilité et la quantité de travail qu'elles vous demandent.

Un connecteur prêt à l'emploi est généralement lui-même une intégration API : le fournisseur a fait le travail, vous n'avez pas à la développer. C'est le choix normal tant que le système que vous voulez connecter figure sur la liste. Voir aussi la différence entre plugin, plateforme d'intégration et API sur mesure.

Qu'est-ce qui peut mal tourner ?

• Limites. Une API n'accepte qu'un certain nombre de requêtes par période. Au-delà, vous recevez la réponse « trop de requêtes » (HTTP 429) et devez patienter ². Avec un grand catalogue, votre intégration doit en tenir compte.
• Accès. Chaque API veut savoir qui fait la demande, généralement avec une clé ou un jeton. Les clés expirent, sont révoquées ou fuitent. Qui les gère ?
• Versions. Une API évolue. Une ancienne version finit par disparaître, et une intégration qui n'a pas été adaptée cesse de fonctionner.
• Erreurs. Une requête peut échouer à cause d'une panne, d'un délai dépassé ou de données incorrectes. Une bonne intégration réessaie et montre ce qui n'a pas fonctionné, au lieu d'échouer en silence.
• Des données qui ne correspondent pas. Catégories, codes de TVA et attributs portent des noms différents partout. Quelqu'un doit les faire correspondre.

Comment évaluer un fournisseur

• Existe-t-il une documentation publique que vous pouvez consulter vous-même ?
• Les données circulent-elles dans un sens ou dans les deux, et à quelle fréquence ?
• Que se passe-t-il en cas d'erreur, et le voyez-vous vous-même ?
• Qui adapte l'intégration quand l'autre partie modifie son API ?
• Quelles limites s'appliquent à votre formule ?

Développer vous-même ou passer par un fournisseur ?

Développer vous-même est rentable si vous avez un processus que personne ne prend en charge en standard, par exemple un ERP maison ou une caisse sur mesure, et si vous avez un développeur qui la maintient aussi après la livraison. Prévoyez le temps de développement, les tests, la gestion des erreurs et les adaptations à chaque évolution d'une API.

Passer par un fournisseur est plus judicieux pour les canaux connus comme les marketplaces ou les fournisseurs. Ces API ne vous sont pas propres, mieux vaut donc partager le travail avec d'autres. La combinaison existe aussi : un connecteur prêt à l'emploi pour les canaux standard, et votre propre logiciel pour le reste.

Ce que propose StoreLinkr : des intégrations et sa propre API

StoreLinkr a deux volets, et vous pouvez les combiner.

Des intégrations prêtes à l'emploi

La liste des intégrations présente les marketplaces, boutiques en ligne, fournisseurs et systèmes d'entrepôt que StoreLinkr connecte déjà. Vous n'avez pas besoin de développer une API pour ceux-là. Si un système n'y figure pas, il n'est pas disponible ; demandez d'abord ce qui est possible. Voir aussi connecter votre boutique en ligne.

L'API E-commerce

Pour ce qui sort de ce cadre, StoreLinkr dispose d'une API E-commerce RESTful. Vos développeurs peuvent l'utiliser pour lire et mettre à jour les produits, appliquer des mouvements de stock, et récupérer et traiter les commandes. En plus de l'API, StoreLinkr prend en charge les webhooks : votre système est prévenu lors d'une nouvelle commande ou d'un changement de stock au lieu de devoir demander sans cesse. Pour l'échange de données, JSON, XML et CSV sont possibles. La documentation publique se trouve sur api.storelinkr.com.

Vos intégrations avec les marketplaces et les boutiques en ligne continuent de fonctionner pendant que votre propre logiciel s'y ajoute via l'API. Les limites applicables dépendent de votre formule et de votre usage. Renseignez-vous avant de développer quelque chose de lourd, et consultez les tarifs.

Questions fréquentes