Introduction
L'API publique de Level vous permet d'interagir par programmation avec vos appareils, groupes, automatisations et bien plus encore. Il s'agit d'une API REST standard : URL orientées ressources, réponses JSON et codes de statut HTTP.
Référence complète de l'API : developers.level.io
⚙️ PRÉREQUIS
Accès administrateur Level (pour générer une clé API)
API publique Level
Générer une clé API
Chaque requête API nécessite une authentification via une clé API.
Dans Level, accédez à Paramètres → Clés API.
Cliquez sur Créer une clé.
Donnez à la clé un nom descriptif qui identifie l'intégration ou le script auquel elle est destinée (par exemple, «Tableau de bord de surveillance» ou «Script de synchronisation personnalisé»).
Cliquez sur Enregistrer et copiez la clé générée.
💡 CONSEIL : Créez une clé API par intégration ou par script. Cela facilite la rotation ou la révocation de l'accès pour un cas d'utilisation spécifique sans en affecter d'autres.
Utilisation de l'API
Toutes les requêtes sont authentifiées avec votre clé API. Consultez la référence de l'API sur developers.level.io pour la documentation des points de terminaison, les formats de requête et les exemples de réponses.
L'API suit les conventions REST standard :
URL orientées ressources
Corps des requêtes et des réponses en JSON
Verbes HTTP standard :
GET,POST,PUT,DELETECodes de statut HTTP standard pour les états de succès et d'erreur
Gérer les clés API
Les clés API sont gérées dans Paramètres → Clés API. Depuis cet emplacement, vous pouvez :
Afficher toutes les clés actives et leurs noms
Régénérer une clé (invalide immédiatement l'ancienne)
Supprimer une clé pour révoquer l'accès
⚠️ AVERTISSEMENT : La régénération ou la suppression d'une clé interrompt immédiatement toute intégration ou tout script qui l'utilise. Mettez à jour la clé dans tous les systèmes dépendants avant d'effectuer une rotation.
FAQ
Qui peut créer des clés API ? Les administrateurs Level. La gestion des clés API se trouve dans Paramètres → Clés API.
Y a-t-il une limite au nombre de clés API que je peux créer ? Non, il n'y a pas de limite. En règle générale, créez une clé par intégration plutôt que de partager une seule clé entre plusieurs systèmes.
Que puis-je faire avec l'API ? La liste complète des fonctionnalités se trouve dans la documentation de référence sur developers.level.io. Les cas d'utilisation courants incluent la consultation de l'état des appareils, le déclenchement d'automatisations, la gestion des groupes et des étiquettes, ainsi que la création de tableaux de bord personnalisés ou d'intégrations de rapports.
Comment authentifier les requêtes API ? Incluez votre clé API dans l'en-tête de la requête. Le format exact de l'en-tête est documenté sur developers.level.io.
Que faire si une clé API est compromise ? Supprimez-la immédiatement dans Paramètres → Clés API. Générez une nouvelle clé et mettez à jour toutes les intégrations qui utilisaient l'ancienne.