Introduction
Les clés API permettent aux outils externes et aux scripts de s'authentifier auprès de l'API de Level. Vous pouvez créer plusieurs clés, limiter chacune à un accès en lecture seule ou en lecture-écriture, et révoquer n'importe quelle clé indépendamment sans affecter les autres.
Utilisations typiques : connexion de scripts personnalisés, extraction de données d'appareils vers des tableaux de bord externes, ou création d'intégrations non couvertes par les connecteurs natifs de Level.
ℹ️ REMARQUE : Les clés API ne sont pas utilisées pour installer l'agent Level. Pour enregistrer un appareil, utilisez la clé d'installation depuis Ajouter un nouvel appareil sur la page Liste des appareils — voir Installation Windows, Installation Linux, ou Installation macOS.
Créer une clé API
Accédez à Paramètres → Clés API, puis cliquez sur + Créer une clé API en haut à droite.
La fenêtre Créer une clé API s'ouvre.
Saisissez une Description — quelque chose d'assez précis pour que vous sachiez à quoi sert cette clé dans plusieurs mois. «Synchronisation inventaire» ou «Intégration personnalisée ConnectWise» est plus utile que «Clé API 1».
Sélectionnez un niveau d'accès :
Lecture et écriture — peut consulter les données et créer, mettre à jour ou supprimer des enregistrements
Lecture seule — peut consulter les données mais ne peut pas créer, mettre à jour ou supprimer
Cliquez sur Créer la clé.
💡 CONSEIL : Utilisez l'accès en lecture seule pour les intégrations qui n'ont besoin que d'extraire des données (outils de reporting, tableaux de bord externes). Réservez la lecture-écriture aux intégrations qui doivent apporter des modifications.
Gérer les clés existantes
La page Clés API répertorie toutes les clés de votre organisation. Chaque ligne affiche :
Clé API — valeur masquée avec les derniers caractères visibles pour identification
Description — le libellé que vous avez attribué lors de la création
Accès — Lecture & écriture ou Lecture seule
Dernière utilisation — horodatage de la dernière requête authentifiée, ou
--si jamais utiliséeCréée — date de génération de la clé
Cliquez sur le menu à trois points à la fin de n'importe quelle ligne pour :
Copier la clé — copie l'identifiant de clé masqué dans votre presse-papiers (pas la valeur secrète complète)
Modifier — mettre à jour la description ou modifier le niveau d'accès
Supprimer — révoquer définitivement la clé
Modifier une clé
Cliquez sur Modifier dans le menu à trois points. La fenêtre Mettre à jour la clé API s'ouvre avec la description actuelle et le niveau d'accès préremplis.
ℹ️ REMARQUE : La modification d'une clé ne change pas la valeur de la clé elle-même. Toute intégration utilisant déjà cette clé continue de fonctionner — elle prend en compte le nouveau niveau d'accès immédiatement.
Supprimer une clé
Cliquez sur Supprimer dans le menu à trois points. La clé est révoquée immédiatement. Toute intégration ou script utilisant cette clé commencera à recevoir des erreurs d'authentification à sa prochaine requête.
⚠️ AVERTISSEMENT : La suppression d'une clé est immédiate et permanente. Mettez à jour toutes les intégrations utilisant la clé avant de la supprimer, sinon elles échoueront.
Rechercher des clés
Utilisez la barre de Recherche en haut de la liste pour filtrer les clés par description. Utile si vous avez accumulé de nombreuses clés et que vous devez en trouver une en particulier.
FAQ
Puis-je voir la valeur complète de la clé API après sa création ? Oui. Cliquez sur le menu à trois points de n'importe quelle clé et sélectionnez Copier la clé pour copier la valeur complète de la clé dans votre presse-papiers à tout moment.
Combien de clés API puis-je créer ? Créez-en autant que nécessaire — une par intégration est une bonne pratique, car elle vous permet de révoquer des intégrations individuelles sans affecter les autres.
Quelle est la différence entre lecture seule et lecture-écriture ? Les clés en lecture seule peuvent récupérer des données depuis l'API mais ne peuvent effectuer aucune modification. Les clés en lecture-écriture peuvent créer, mettre à jour et supprimer des enregistrements. Utilisez le niveau d'accès minimal dont votre intégration a réellement besoin.
Qui peut créer et gérer des clés API ? Les techniciens ayant accès aux Paramètres. Voir Espace de travail → Autorisations pour plus de détails sur les contrôles d'accès basés sur les rôles.
Une intégration a cessé de fonctionner après que j'ai modifié une clé. Pourquoi ? La modification du niveau d'accès de lecture-écriture à lecture seule prend effet immédiatement. Si l'intégration dépendait de l'accès en écriture, elle commencera à échouer pour toute requête tentant de créer, mettre à jour ou supprimer des données. Consultez les journaux d'erreurs de l'intégration pour des réponses 403.
Puis-je savoir quelle intégration utilise quelle clé ? Le champ Description est le seul identifiant — Level ne journalise pas quel système a effectué une requête API donnée avec une clé. Utilisez des noms descriptifs lors de la création afin de pouvoir associer les clés aux intégrations ultérieurement.