Einführung
API-Schlüssel ermöglichen es externen Tools und Skripten, sich bei der API von Level zu authentifizieren. Sie können mehrere Schlüssel erstellen, jeden einzelnen auf Nur-Lesen- oder Lesen-und-Schreiben-Zugriff beschränken und jeden Schlüssel unabhängig widerrufen, ohne die anderen zu beeinflussen.
Typische Anwendungsfälle: Verbindung benutzerdefinierter Skripte, Abrufen von Gerätedaten in externe Dashboards oder Erstellen von Integrationen, die nicht von den integrierten Konnektoren von Level abgedeckt werden.
ℹ️ HINWEIS: API-Schlüssel werden nicht zur Installation des Level-Agenten verwendet. Um ein Gerät zu registrieren, verwenden Sie den Installationsschlüssel von Neues Gerät hinzufügen auf der Gerätelistenseite — siehe Windows-Installation, Linux-Installation, oder macOS-Installation.
Einen API-Schlüssel erstellen
Navigieren Sie zu Einstellungen → API-Schlüssel, dann klicken Sie auf + API-Schlüssel erstellen oben rechts.
Das API-Schlüssel erstellen Dialogfenster öffnet sich.
Geben Sie eine Beschreibung — etwas Spezifisches genug, damit Sie auch noch Monate später wissen, wofür dieser Schlüssel verwendet wird. „InventarSync" oder „ConnectWise benutzerdefinierte Integration" ist hilfreicher als „API-Schlüssel 1".
Wählen Sie eine Zugriffsebene aus:
Lesen und Schreiben — kann Daten anzeigen sowie Einträge erstellen, aktualisieren oder löschen
Nur-Lesen — kann Daten anzeigen, aber keine Einträge erstellen, aktualisieren oder löschen
Klicken Sie auf Schlüssel erstellen.
💡 TIPP: Verwenden Sie Nur-Lesen-Zugriff für Integrationen, die nur Daten abrufen müssen (Berichtstools, externe Dashboards). Behalten Sie Lesen-und-Schreiben für Integrationen vor, die Änderungen vornehmen müssen.
Vorhandene Schlüssel verwalten
Die API-Schlüssel Seite listet alle Schlüssel Ihrer Organisation auf. Jede Zeile zeigt:
API-Schlüssel — maskierter Wert mit den letzten paar Zeichen zur Identifikation sichtbar
Beschreibung — die Bezeichnung, die Sie bei der Erstellung vergeben haben
Zugriff — Lesen & Schreiben oder Nur-Lesen
Zuletzt verwendet — Zeitstempel der letzten authentifizierten Anfrage, oder
--wenn noch nie verwendetErstellt — Zeitpunkt, zu dem der Schlüssel generiert wurde
Klicken Sie auf das Drei-Punkte-Menü am Ende einer beliebigen Zeile, um:
Schlüssel kopieren — kopiert den maskierten Schlüsselidentifikator in Ihre Zwischenablage (nicht den vollständigen geheimen Wert)
Bearbeiten — Beschreibung aktualisieren oder Zugriffsebene ändern
Löschen — Schlüssel dauerhaft widerrufen
Einen Schlüssel bearbeiten
Klicken Sie auf Bearbeiten aus dem Drei-Punkte-Menü. Das API-Schlüssel aktualisieren Dialogfenster öffnet sich mit der aktuellen Beschreibung und der vorausgefüllten Zugriffsebene.
ℹ️ HINWEIS: Das Bearbeiten eines Schlüssels ändert nicht den Schlüsselwert selbst. Jede Integration, die diesen Schlüssel bereits verwendet, funktioniert weiterhin — die neue Zugriffsebene wird sofort übernommen.
Einen Schlüssel löschen
Klicken Sie auf Löschen aus dem Drei-Punkte-Menü. Der Schlüssel wird sofort widerrufen. Jede Integration oder jedes Skript, das diesen Schlüssel verwendet, erhält bei der nächsten Anfrage Authentifizierungsfehler.
⚠️ WARNUNG: Das Löschen eines Schlüssels ist sofort und dauerhaft. Aktualisieren Sie alle Integrationen, die den Schlüssel verwenden, bevor Sie ihn löschen, oder rechnen Sie damit, dass diese fehlschlagen.
Schlüssel suchen
Verwenden Sie die Suche Leiste oben in der Liste, um Schlüssel nach Beschreibung zu filtern. Nützlich, wenn Sie viele Schlüssel angesammelt haben und einen bestimmten finden müssen.
Häufig gestellte Fragen
Kann ich den vollständigen API-Schlüsselwert nach der Erstellung einsehen? Ja. Klicken Sie auf das Drei-Punkte-Menü eines beliebigen Schlüssels und wählen Sie Schlüssel kopieren um den vollständigen Schlüsselwert jederzeit in Ihre Zwischenablage zu kopieren.
Wie viele API-Schlüssel kann ich erstellen? Erstellen Sie so viele wie nötig — einer pro Integration ist eine sinnvolle Praxis, da Sie so einzelne Integrationen widerrufen können, ohne andere zu beeinflussen.
Was ist der Unterschied zwischen Nur-Lesen und Lesen-und-Schreiben? Nur-Lesen-Schlüssel können Daten von der API abrufen, aber keine Änderungen vornehmen. Lesen-und-Schreiben-Schlüssel können Einträge erstellen, aktualisieren und löschen. Verwenden Sie die minimale Zugriffsebene, die Ihre Integration tatsächlich benötigt.
Wer kann API-Schlüssel erstellen und verwalten? Techniker mit Zugriff auf Einstellungen. Siehe Arbeitsbereich → Berechtigungen für Details zu rollenbasierter Zugriffskontrolle.
Eine Integration funktioniert nicht mehr, nachdem ich einen Schlüssel bearbeitet habe. Warum? Eine Änderung der Zugriffsebene von Lesen-und-Schreiben auf Nur-Lesen wird sofort wirksam. Wenn die Integration auf Schreibzugriff angewiesen war, schlägt sie bei allen Anfragen fehl, die versuchen, Daten zu erstellen, zu aktualisieren oder zu löschen. Überprüfen Sie die Fehlerprotokolle der Integration auf 403-Antworten.
Kann ich erkennen, welche Integration welchen Schlüssel verwendet? Das Beschreibungsfeld ist der einzige Bezeichner — Level protokolliert nicht, welches System eine bestimmte API-Anfrage mit einem Schlüssel gestellt hat. Verwenden Sie beim Erstellen beschreibende Namen, damit Sie Schlüssel später den Integrationen zuordnen können.