Une API (interface de programmation) est une porte par laquelle un programme, et non une personne, dialogue avec votre marketplace. Ce que vous faites à la main dans l’espace d’administration, un programme peut le faire par l’API, aussi souvent qu’il le faut.

À quoi elle sert

  • Relier vos logiciels de gestion : envoyer chaque nouvelle commande à votre ERP ou à votre outil comptable, tenir le stock à jour avec un entrepôt.
  • Importer ou mettre à jour un catalogue : créer des centaines d’annonces depuis un tableur ou le catalogue d’un fournisseur.
  • Construire une application mobile ou votre propre vitrine : vos utilisateurs se connectent, parcourent, commandent et suivent leurs commandes depuis une application.
  • Permettre à un vendeur de brancher son propre logiciel : son catalogue et ses commandes restent alignés sur l’outil qu’il utilise déjà.
  • Garder vos propres données sur les objets : enregistrer une référence externe sur un utilisateur, une annonce ou une commande (une métadonnée, ou metafield dans l’API).

Les trois API

API Pour qui elle agit Usage type
API Admin Vous, l’administrateur : elle voit toute la marketplace Votre ERP, CRM ou outil comptable, les imports de catalogue, l’automatisation
API Front Un utilisateur, vendeur ou acheteur, connecté avec son e-mail et son mot de passe Une application mobile, une vitrine que vous construisez vous-même
API Partners Un vendeur : elle ne voit que ses annonces et ses commandes Le logiciel de stock, de commandes ou d’entrepôt d’un vendeur

API Admin. Elle agit avec les droits d’un administrateur : elle s’utilise depuis un serveur, jamais depuis une page que vos utilisateurs chargent. Chaque administrateur génère sa propre clé et son propre secret : voir Obtenir vos clés de l’API Admin.

API Front. Un utilisateur se connecte depuis l’application avec son propre e-mail et son mot de passe ; il n’y a pas de clé à générer.

API Partners. Aucun écran ne permet de générer son accès : il est délivré sur demande, pour un vendeur donné. Contactez le support Kreezalid en indiquant votre marketplace et le compte du vendeur.

Être prévenu quand quelque chose change

Plutôt que d’interroger l’API toutes les quelques minutes pour savoir si une commande est arrivée, un programme peut être prévenu : un webhook envoie un message à l’URL de votre choix dès qu’un utilisateur, une annonce ou une commande change. Voir Webhooks sur le portail développeur.

Où les développeurs trouvent la documentation

Le portail développeur, en anglais, décrit chaque API : le démarrage rapide, l’authentification, la référence complète de chaque requête, et des guides pas à pas (importer un catalogue, envoyer les commandes à un ERP, construire une application mobile).

Pour essayer une requête vous-même sans écrire de code, voir Tester l’API Admin avec un client d’API.

Ce que vos utilisateurs voient

Rien ne change pour les vendeurs et les acheteurs tant que vous n’utilisez l’API que depuis vos propres outils. Ce qu’un programme crée ou modifie par l’API (une annonce, une page, le statut d’une commande) apparaît ensuite sur la vitrine et dans leur compte comme si vous l’aviez fait dans l’espace d’administration.

Cas particuliers et limites

  • Un domaine personnalisé connecté : les API répondent sur le domaine principal de votre marketplace, c’est-à-dire votre domaine personnalisé dès qu’il est connecté. Un programme qui appelle l’URL en mykreezalid.com reçoit une redirection, que beaucoup de programmes ne suivent pas.
  • Pas de droits par clé : une clé de l’API Admin peut tout ce que peut un administrateur. Ne la confiez qu’à votre développeur.
  • L’utilisation est mesurée : Paramètres › Utilisation des API montre les appels reçus par votre marketplace, API par API. Un trafic qui nuit à la marketplace peut être ralenti ou refusé.
  • Un agent IA comme ChatGPT ou Claude n’utilise pas ces clés : il se connecte par MCP, avec les droits que vous lui accordez. Voir Connecter un agent IA à votre marketplace avec MCP.