Introduction
Les clés API permettent aux outils et scripts externes de s'authentifier auprès de l'API de Level. Vous pouvez créer plusieurs clés, définir l'accès en lecture seule ou en lecture-écriture pour chacune 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'appareil dans 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
Navigate to Paramètres → Clés API , then click + Créer une clé API dans le coin supérieur droit.
The Créer une clé API modale s'ouvre.
Enter a Description — quelque chose de suffisamment spécifique pour que vous sachiez à quoi servira cette clé dans quelques mois. « Synchronisation d'inventaire » ou « Intégration personnalisée ConnectWise » est plus utile que « Clé API 1 ».
Sélectionnez un niveau d'accès:
Lire et écrire — peuvent afficher les données et créer, mettre à jour ou supprimer les enregistrements
Lecture seule — peuvent afficher les données mais ne peuvent pas créer, mettre à jour ou supprimer
Click Créer une clé .
💡 CONSEIL: Utilisez l'accès en lecture seule pour les intégrations qui ont besoin de extraire uniquement des données (outils de rapport, tableaux de bord externes). Réservez la lecture-écriture pour les intégrations qui ont besoin d'apporter des modifications.
Gestion des clés existantes
The 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 — le libellé que vous avez attribué à la création
Accès — Lire et écrire ou Lecture seule
Dernier utiliséhorodatage de la requête authentifiée la plus récente, ou
--si jamais utiliséCréé — quand la clé a été générée
Cliquez sur le menu à trois points à la fin de n'importe quelle ligne pour:
Copier la clé — copie l'identificateur de clé masqué dans votre presse-papiers (pas la valeur secrète complète)
Modifier — mettez à jour la description ou modifiez le niveau d'accès
Supprimer — révoquer définitivement la clé
Modification d'une clé
Click Modifier dans le menu trois points. LeMettre à jour la clé API la boîte de dialogue 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 adopte le nouveau niveau d'accès immédiatement.
Suppression d'une clé
Click Supprimer du 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 demande.
⚠️ AVERTISSEMENT: La suppression de clé est immédiate et permanente. Mettez à jour toute intégration utilisant la clé avant de la supprimer, ou attendez-vous à ce qu'elle échoue.
Recherche de clés
Use the Chercher 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 sa création? Oui. Cliquez sur le menu trois points sur n'importe quelle clé et sélectionnezCopier 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 autant que vous le souhaitez — une par intégration est une pratique raisonnable car elle vous permet de révoquer des intégrations individuelles sans en affecter d'autres.
Quelle est la différence entre lecture seule et lecture-écriture? Les clés en lecture seule peuvent récupérer les données de l'API mais ne peuvent effectuer aucun changement. Les clés de lecture-écriture peuvent créer, mettre à jour et supprimer les enregistrements. Utilisez le niveau d'accès minimal dont votre intégration a réellement besoin.
Qui peut créer et gérer les clés API? Techniciens ayant accès aux paramètres. VoirEspace 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 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 reposait sur un accès en écriture, elle commencera à échouer sur toute demande qui tente de créer, mettre à jour ou supprimer des données. Vérifiez les journaux d'erreur 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 n'enregistre pas quel système a effectué une demande API donnée contre une clé. Utilisez des noms descriptifs au moment de la création afin que vous puissiez associer les clés aux intégrations ultérieurement.