# 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.

Ouvrir dans Kinmu: <https://my.kinmu.app/fr/dashboard/company#public-api>

## Sur le web

1. ### Ouvrir l’entreprise

   Sélectionnez **Mon entreprise**.

   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](https://docs.kinmu.app/).
