Passer au contenu principal

Comment créer une clé API pour une intégration ?

Dans Mon entreprise, ouvrez API publique, créez une clé avec les droits nécessaires et copiez-la : elle ne sera affichée qu’une seule fois.

Sur cette page

Sur le web

  1. Ouvrir l’entreprise

    Sélectionnez Mon entreprise Ouvrir dans Kinmu Nécessite l’extension API publique.

    La configuration de l’entreprise apparaît.

  2. Ouvrir l’API

    Sous Extensions, sélectionnez API publique.

    L’onglet des clés API s’ouvre.

  3. Créer une clé

    Sélectionnez Créer la clé API.

    Le formulaire apparaît.

  4. Nommer l’intégration

    Renseignez Nom. Si les environnements sont proposés, choisissez la production ou le bac à sable, qui utilise une entreprise de test et des données fictives.

    Le nom et l’environnement sont définis.

  5. Définir l’expiration

    Choisissez une durée ou l’absence d’expiration.

    Une clé limitée dans le temps cessera automatiquement de fonctionner à l’échéance.

  6. Choisir les droits

    Sélectionnez uniquement les droits nécessaires à votre intégration.

    Les droits choisis apparaissent dans le formulaire.

  7. Générer la clé

    Sélectionnez Créer la clé.

    La clé complète apparaît pour la seule fois.

  8. Copier la clé

    Copiez-la, conservez-la dans un emplacement sûr, puis sélectionnez Terminé.

    La clé apparaît masquée dans la liste.

Si l’option n’apparaît pas

  • Sur votre téléphone, ouvrez d’abord le menu avec le bouton de menu.
  • L’extension d’API publique et le rôle Administrateur Global ou Manager sont nécessaires.
  • Si le maximum de clés actives est atteint, révoquez-en une avant d’en créer une nouvelle. Sélectionnez au moins un droit.

Questions fréquentes

Puis-je retrouver une clé perdue ?

Non. Faites une rotation ou créez-en une nouvelle. L’ancienne cesse immédiatement de fonctionner après rotation : mettez vos intégrations à jour.

Comment bloquer une intégration ?

Révoquez sa clé. L’effet est immédiat et irréversible.

Résultat

La clé est disponible pour votre intégration, qui l’envoie dans l’en-tête Authorization: Bearer. La référence technique est sur docs.kinmu.app.

Cet article vous a-t-il aidé ?
D’autres guides sur ce thème compte, ia et intégrations →

Vous n’avez pas trouvé votre réponse ? Écrivez-nous