L'API publique de Level te permet de construire des intégrations personnalisées, d'extraire des données de dispositifs et d'alertes dans tes propres outils, et d'automatiser les flux de travail en dehors de l'ensemble d'intégrations natif de Level.

L'API utilise REST et renvoie du JSON. Toutes les demandes doivent être authentifiées avec une clé API. Il n'y a pas de limite stricte de débit, mais les appels excessifs seront limités.

⚙️ PRÉREQUIS

Accès administrateur à Level (pour générer les clés API)
Connaissance de base des API REST et de JSON
Un client HTTP ou une bibliothèque pour faire des demandes (curl, Postman, Python requests, etc.)

API Publique de Level

Générer une clé API

1. Connecte-toi à Level en tant qu'administrateur.

2. Va à Paramètres → Clés API.

3. Clique sur Générer une nouvelle clé.

4. Donne un nom à la clé (par exemple, « Intégration personnalisée » ou « Sync de données »).

5. Clique sur Créer une clé. Level génère une clé secrète. Copie-la et stocke-la de manière sécurisée — tu ne pourras pas la voir à nouveau.

⚠️ AVERTISSEMENT : Les clés API accordent l'accès par programme à ton organisation Level. Traite-les comme des mots de passe. Si une clé est compromise, supprime-la immédiatement et génère-en une nouvelle.

Authentification

Inclus ta clé API dans le header Authorization de chaque demande :

Authorization: Bearer YOUR_API_KEY

Exemple avec curl :

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.level.io/v1/devices

Points d'accès (Endpoints)

L'API est hébergée sur https://api.level.io/v1.

Dispositifs

GET /devices — Liste tous les dispositifs
GET /devices/{id} — Obtenir un dispositif spécifique
GET /devices/{id}/alerts — Lister les alertes d'un dispositif

Alertes

GET /alerts — Liste toutes les alertes
GET /alerts/{id} — Obtenir une alerte spécifique

Organisations

GET /organizations — Liste toutes les organisations
GET /organizations/{id} — Obtenir une organisation spécifique

Demandes et réponses

Les réponses sont renvoyées au format JSON avec un code de statut HTTP approprié.

Exemple de demande :

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.level.io/v1/devices?limit=10

Exemple de réponse :

{\n  "data": [\n    {\n      "id": "device-123",\n      "name": "ACME-PC-001",\n      "organization_id": "org-456",\n      "status": "online"\n    }\n  ],\n  "pagination": {\n    "total": 42,\n    "limit": 10,\n    "offset": 0\n  }\n}

Pagination

Les réponses de liste prennent en charge la pagination via les paramètres limit et offset.

GET /devices?limit=20&offset=40

Gérer les clés API

Tu peux révoquer une clé API à tout moment :

Va à Paramètres → Clés API.
Trouve la clé dans la liste et clique sur Révoquer.

Une fois révoquée, la clé ne fonctionnera plus pour les nouvelles demandes.

💡 CONSEIL : Si tu soupçonnes qu'une clé est compromise, revoque-la immédiatement et crée-en une nouvelle. Les demandes en cours utilisant la clé compromise échoueront, mais cela empêchera tout accès non autorisé.

FAQ

Qui peut générer une clé API ? Seuls les administrateurs Level peuvent générer et révoquer les clés API.
Y a-t-il une limite au nombre de clés API que je peux créer ? Non. Tu peux créer autant de clés que nécessaire.
Puis-je limiter les permissions d'une clé API à des domaines ou des organisations spécifiques ? Actuellement, les clés API ont accès à toute l'organisation. Les permissions granulaires sont sur la feuille de route.
Que se passe-t-il si ma clé API est compromise ? Revoque-la immédiatement. Accède à Paramètres → Clés API, trouve la clé, et clique sur Révoquer. Crée-en une nouvelle.
L'API supporte-t-elle les demandes POST ou PUT pour modifier les données ? Actuellement, l'API est en lecture seule. Les capacités d'écriture (POST, PUT, DELETE) sont en développement.