Introduction
L'API publique de Level vous permet d'interagir avec vos appareils, groupes, automations, et plus par programmation. C'est une API REST standard : URLs orientées ressources, réponses JSON et codes d'état HTTP.
Référence API complète :developers.level.io
⚙️ CONDITIONS PRÉALABLES
Accès administrateur Level (pour générer une clé API)
API publique Level
Générer une clé API
Chaque demande API nécessite une authentification via une clé API.
Dans Level, accédez àParamètres → Clés API .
Click Create Key.
Donnez à la clé un nom descriptif qui identifie l'intégration ou le script pour lequel elle est destinée (par exemple, « Tableau de bord de surveillance » ou « Script de synchronisation personnalisé »).
Click Save et copiez la clé générée.
💡 TIP:Créez une clé API par intégration ou script. Cela rend plus facile la rotation ou la révocation de l'accès pour un cas d'utilisation spécifique sans affecter d'autres.
Using the API
Toutes les demandes sont authentifiées avec votre clé API. Consultez la référence API à developers.level.io pour la documentation des points de terminaison, les formats de demande et les réponses d'exemple.
L'API suit les conventions REST standard :
URLs orientées ressources
Corps de demande et réponse JSON
Verbes HTTP standards :
GET,POST,PUT,DELETECodes d'état HTTP standards pour les états de succès et d'erreur
Manage API Keys
Les clés API sont gérées àParamètres → Clés API. De là vous pouvez :
Afficher toutes les clés actives et leurs noms
Régénérer une clé (invalide l'ancienne immédiatement)
Supprimer une clé pour révoquer l'accès
⚠️ WARNING:Régénérer ou supprimer une clé casse immédiatement toute intégration ou script qui l'utilise. Mettez à jour la clé dans tous les systèmes dépendants avant de la faire tourner.
FAQ
Qui peut créer des clés API ?Administrateurs Level. La gestion des clés API se trouve sousParamè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 général, 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 capacités se trouve dans les documents de référence àdevelopers.level.io . Les cas d'utilisation courants incluent l'interrogation de l'état du dispositif, le déclenchement d'automations, la gestion de groupes et d'étiquettes, et la création de tableaux de bord personnalisés ou d'intégrations de rapports.
Comment authentifier les demandes API ?Incluez votre clé API dans l'en-tête de la demande. Le format exact de l'en-tête est documenté àdevelopers.level.io .
Que faire si une clé API est compromise ?Supprimez-la immédiatement à Paramètres → Clés API . Générez une nouvelle clé et mettez à jour toutes les intégrations qui ont utilisé l'ancienne.