Introduction
Die öffentliche API von Level ermöglicht es Ihnen, programmgesteuert mit Ihren Geräten, Gruppen, Automatisierungen und mehr zu interagieren. Es ist eine Standard-REST-API: ressourcenorientierte URLs, JSON-Antworten und HTTP-Statuscodes.
Vollständige API-Referenz:developers.level.io
⚙️ VORAUSSETZUNGEN
Level-Administratorzugriff (zum Generieren eines API-Schlüssels)
Level öffentliche API
Generieren Sie einen API-Schlüssel
Jede API-Anfrage benötigt Authentifizierung über einen API-Schlüssel.
In Level gehen Sie zuEinstellungen → API Keys.
Click Create Key.
Geben Sie dem Schlüssel einen aussagekräftigen Namen, der die Integration oder das Skript identifiziert, für das er bestimmt ist (beispielsweise "Monitoring Dashboard" oder "Custom Sync Script").
Click Saveund kopieren Sie den generierten Schlüssel.
💡 TIP:Erstellen Sie einen API-Schlüssel pro Integration oder Skript. Dies macht es einfacher, den Zugriff für einen bestimmten Anwendungsfall zu rotieren oder zu widerrufen, ohne andere zu beeinträchtigen.
Using the API
Alle Anfragen werden mit Ihrem API-Schlüssel authentifiziert. Beziehen Sie sich auf die API-Referenz unterdevelopers.level.iofür Endpunkt-Dokumentation, Anfrage-Formate und Beispielantworten.
Die API folgt Standard-REST-Konventionen:
Ressourcenorientierte URLs
JSON-Request- und Response-Bodies
Standard-HTTP-Verben:
GET,POST,PUT,DELETEStandard-HTTP-Statuscodes für Erfolgs- und Fehlerzustände
Manage API Keys
API-Schlüssel werden verwaltet unterEinstellungen → API Keys. Von dort aus können Sie:
Alle aktiven Schlüssel und deren Namen anzeigen
Einen Schlüssel regenerieren (invalidiert den alten sofort)
Einen Schlüssel löschen, um den Zugriff zu widerrufen
⚠️ WARNING:Das Regenerieren 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 vor der Rotation.
FAQ
Wer kann API-Schlüssel erstellen?Level-Administratoren. Die API-Schlüsselverwaltung befindet sich unterEinstellungen → API Keys.
Gibt es eine Grenze für die Anzahl der API-Schlüssel, die ich erstellen kann?Nein, es gibt keine Grenze. Erstellen Sie im Allgemeinen einen Schlüssel pro Integration, anstatt einen einzelnen Schlüssel über mehrere Systeme zu teilen.
Was kann ich mit der API tun?Die vollständige Funktionsliste finden Sie in den Referenzdokumenten unterdevelopers.level.io. Häufige Anwendungsfälle sind Abfrage des Gerätestatus, Auslösen von Automatisierungen, Verwalten von Gruppen und Tags sowie Erstellen benutzerdefinierter Dashboards oder Reporting-Integrationen.
Wie authentifiziere ich API-Anfragen?Fügen Sie Ihren API-Schlüssel in den Request-Header ein. Das genaue Header-Format ist unterdevelopers.level.io.
Was mache ich, wenn ein API-Schlüssel kompromittiert wird?Löschen Sie ihn sofort unterEinstellungen → API Keys. Generieren Sie einen neuen Schlüssel und aktualisieren Sie alle Integrationen, die den alten verwendet haben.