La clé d’API et le secret API fonctionnent ensemble, comme un nom d’utilisateur et un mot de passe : la clé dit qui appelle, le secret le prouve.

Générer vos clés

  1. Dans le menu, rubrique Configuration, cliquez sur Paramètres.

  2. Dans le groupe Marketplace, cliquez sur la carte Compte & équipe. L’écran Compte s’ouvre.

  3. Dans la section API access, cliquez sur Générer une clé secrète. Le message de confirmation « Identifiants API créés avec succès. » s’affiche.

  4. La section montre maintenant deux champs :

    • Clé d’API : elle commence par pk_ ;
    • Secret API : il commence par sk_.

    Cliquez dans un champ pour sélectionner sa valeur, puis copiez-la.

Transmettez les deux valeurs à votre développeur par un moyen qui les garde privées (un gestionnaire de mots de passe, par exemple), jamais dans un simple e-mail ou un document partagé.

Remplacer vos clés

Remplacez-les quand elles ont pu fuiter, quand une personne qui les connaissait quitte le projet, ou pour couper une ancienne intégration :

  1. Ouvrez Paramètres › Compte & équipe.
  2. Dans la section API access, cliquez sur Générer une nouvelle clé d’API.

Une nouvelle clé et un nouveau secret sont créés, et l’ancienne paire cesse aussitôt de fonctionner : il n’y a pas de fenêtre de confirmation. Mettez à jour tout de suite chaque outil qui utilisait l’ancienne paire.

Il n’y a pas de bouton pour désactiver les clés : générer une nouvelle paire est la façon de couper l’accès.

Donner à une intégration ses propres clés

Les clés appartiennent à l’administrateur qui les a générées, et lui seul les voit à l’écran. S’il génère de nouvelles clés, tous les outils qui utilisent sa paire s’arrêtent.

Pour une intégration durable (un ERP, un outil comptable), créez un administrateur qui lui est dédié, par exemple integration@votre-societe.fr : dans la section Comptes et permissions du même écran, cliquez sur Ajouter un compte administrateur (seul le propriétaire du compte voit ce bouton). Une fois l’invitation acceptée, cet administrateur génère les clés, et l’intégration ne dépend plus d’une personne.

Ce que vos utilisateurs voient

Rien : les clés n’existent que dans l’espace d’administration et dans les outils auxquels vous les confiez.

Cas particuliers et limites

  • Pas de clé limitée : une paire a tous les droits d’un administrateur, sur toute la marketplace. Il n’y a ni clé en lecture seule ni clé réservée à certaines données.
  • L’adresse e-mail comme clé : d’anciennes intégrations envoient l’adresse e-mail de l’administrateur à la place de la clé pk_, avec le même secret. Cela fonctionne toujours ; utilisez la clé pk_ pour tout nouvel usage. Un administrateur dont le secret date d’avant les clés pk_ voit son adresse e-mail dans le champ Clé d’API : Générer une nouvelle clé d’API lui donne une clé pk_, et coupe l’ancienne paire.
  • API Partners : l’accès d’un vendeur à l’API Partners ne se génère pas sur cet écran. Il est délivré sur demande : contactez le support Kreezalid en indiquant votre marketplace et le compte du vendeur.
  • API Front : il n’y a pas de clé ; un utilisateur se connecte avec son propre e-mail et son mot de passe.