Einführung
Die öffentliche API von Level ermöglicht es Ihnen, programmgesteuert mit Ihren Geräten, Gruppen, Automatisierungen und mehr zu interagieren. Es handelt sich um eine Standard-REST-API: ressourcenorientierte URLs, JSON-Antworten und HTTP-Statuscodes.
Vollständige API-Referenz: developers.level.io
⚙️ VORAUSSETZUNGEN
Level-Administratorzugang (zum Generieren eines API-Schlüssels)
Level Öffentliche API
Einen API-Schlüssel generieren
Jede API-Anfrage erfordert eine Authentifizierung über einen API-Schlüssel.
Navigieren Sie in Level zu Einstellungen → API-Schlüssel.
Klicken Sie auf Schlüssel erstellen.
Geben Sie dem Schlüssel einen beschreibenden Namen, der die Integration oder das Skript identifiziert, für die er bestimmt ist (zum Beispiel „Monitoring-Dashboard" oder „Benutzerdefiniertes Synchronisierungsskript").
Klicken Sie auf Speichern und kopieren Sie den generierten Schlüssel.
💡 TIPP: Erstellen Sie einen API-Schlüssel pro Integration oder Skript. Dies erleichtert es, den Zugriff für einen bestimmten Anwendungsfall zu rotieren oder zu widerrufen, ohne andere zu beeinträchtigen.
Die API verwenden
Alle Anfragen werden mit Ihrem API-Schlüssel authentifiziert. Weitere Informationen finden Sie in der API-Referenz unter developers.level.io für Endpunkt-Dokumentation, Anfrageformate und Beispielantworten.
Die API folgt Standard-REST-Konventionen:
Ressourcenorientierte URLs
JSON-Anfrage- und Antworttexte
Standard-HTTP-Verben:
GET,POST,PUT,DELETEStandard-HTTP-Statuscodes für Erfolgs- und Fehlerzustände
API-Schlüssel verwalten
API-Schlüssel werden verwaltet unter Einstellungen → API-Schlüssel. Von dort aus können Sie:
Alle aktiven Schlüssel und ihre Namen anzeigen
Einen Schlüssel neu generieren (macht den alten sofort ungültig)
Einen Schlüssel löschen, um den Zugriff zu widerrufen
⚠️ WARNUNG: Das Neu-Generieren oder Löschen eines Schlüssels unterbricht sofort jede Integration oder jedes Skript, das ihn verwendet. Aktualisieren Sie den Schlüssel in allen abhängigen Systemen, bevor Sie ihn rotieren.
Häufig gestellte Fragen
Wer kann API-Schlüssel erstellen? Level-Administratoren. Die Verwaltung von API-Schlüsseln befindet sich unter Einstellungen → API-Schlüssel.
Gibt es eine Begrenzung für die Anzahl der API-Schlüssel, die ich erstellen kann? Nein, es gibt keine Begrenzung. Als allgemeine Praxis empfiehlt es sich, einen Schlüssel pro Integration zu erstellen, anstatt einen einzelnen Schlüssel über mehrere Systeme hinweg zu teilen.
Was kann ich mit der API tun? Die vollständige Liste der Funktionen finden Sie in der Referenzdokumentation unter developers.level.io. Zu den häufigen Anwendungsfällen gehören das Abfragen des Gerätestatus, das Auslösen von Automatisierungen, das Verwalten von Gruppen und Tags sowie das Erstellen benutzerdefinierter Dashboards oder Reporting-Integrationen.
Wie authentifiziere ich API-Anfragen? Fügen Sie Ihren API-Schlüssel in den Anfrage-Header ein. Das genaue Header-Format ist dokumentiert unter developers.level.io.
Was soll ich tun, wenn ein API-Schlüssel kompromittiert wurde? Löschen Sie ihn sofort unter Einstellungen → API-Schlüssel. Generieren Sie einen neuen Schlüssel und aktualisieren Sie alle Integrationen, die den alten verwendet haben.