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, attribuer à 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 intégrés de Level.
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 d'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, modifier ou supprimer des enregistrements
Lecture seule — peut consulter les données mais ne peut pas créer, modifier 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 effectuer 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 à des fins d'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 en fin de 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 boîte de dialogue Mettre à jour la clé API s'ouvre avec la description et le niveau d'accès actuels 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 tout 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, ou attendez-vous à ce qu'elles échouent.
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 consulter 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 pratique raisonnable, car elle vous permet de révoquer des intégrations individuellement 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, modifier 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. Consultez 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 la modification d'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 sur toutes les requêtes tentant de créer, modifier ou supprimer des données. Vérifiez les journaux d'erreurs de l'intégration pour les réponses 403.
Puis-je savoir quelle intégration utilise quelle clé ? Le champ Description est le seul identifiant — Level ne consigne 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.