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, définir la portée de chacune pour 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 de périphérique vers des tableaux de bord externes, ou création d'intégrations non couvertes par les connecteurs intégrés de Level.
Création d'une clé API
Accédez à Paramètres → Clés API, puis cliquez sur + Créer une clé API en haut à droite.
La boîte de dialogue Créer une clé API s'ouvre.
Entrez une Description – quelque chose de spécifique enough que vous saurez ce que cette clé est destinée mois à partir de maintenant. « 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 voir les données et créer, mettre à jour ou supprimer des enregistrements
Lecture seule – peut voir les données mais ne peut pas créer, mettre à jour ou supprimer
Cliquez sur Créer une clé.
💡 CONSEIL : Utilisez l'accès en lecture seule pour les intégrations qui doivent uniquement extraire des données (outils de rapport, tableaux de bord externes). Réservez la lecture-écriture pour les intégrations qui doivent apporter des modifications.
Gestion des 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 l'identification
Description – l'étiquette que vous avez assignée lors de la création
Accès – Lecture et écriture ou Lecture seule
Dernière utilisation – timestamp de la demande authentifiée la plus récente, ou
--si jamais utiliséeCréé – quand la clé a été générée
Cliquez sur le menu à trois points à la fin de n'importe quelle ligne pour :
Copier une 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é
Modification d'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 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. N'importe quelle intégration utilisant déjà cette clé continue de fonctionner – elle récupère le nouveau niveau d'accès immédiatement.
Suppression d'une clé
Cliquez sur Supprimer dans le menu à trois points. La clé est révoquée immédiatement. N'importe quelle intégration ou script utilisant cette clé commencera à recevoir des erreurs d'authentification lors de sa prochaine demande.
⚠️ AVERTISSEMENT : La suppression de clé est immédiate et permanente. Mettez à jour n'importe quelles intégrations utilisant la clé avant de supprimer, ou attendez-vous à ce qu'elles échouent.
Recherche de clés
Utilisez la barre de Recherche en haut de la liste pour filtrer les clés par description. Utile si vous avez accumulé beaucoup de clés et avez besoin d'en trouver une spécifique.
FAQ
Puis-je voir la valeur complète de la clé API après création ? Oui. Cliquez sur le menu à trois points sur n'importe quelle clé et sélectionnez Copier une 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 autant que vous en avez besoin – une par intégration est une pratique raisonnable car cela 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 de l'API mais ne peuvent apporter aucun changement. Les clés en lecture-écriture peuvent créer, mettre à jour et supprimer des enregistrements. Utilisez le niveau d'accès minimum que votre intégration nécessite réellement.
Qui peut créer et gérer des clés API ? Les techniciens ayant accès à Paramètres. Consultez Espace de travail → Permissions 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 avoir modifié une clé. Pourquoi ? La modification du niveau d'accès de lecture-écriture à lecture seule prend effet immédiatement. Si l'intégration reposait sur l'accès en écriture, elle commencera à échouer sur les demandes qui tentent de créer, mettre à jour ou supprimer des données. Vérifiez les journaux d'erreurs de l'intégration pour les réponses 403.
Puis-je dire quelle intégration utilise quelle clé ? Le champ Description est le seul identifiant – Level ne consigne pas quel système a fait une demande API donnée contre une clé. Utilisez des noms descriptifs lors de la création afin de pouvoir associer les clés aux intégrations ultérieurement.