Einführung
Mit API-Schlüsseln können externe Tools und Skripte sich bei der API von Level authentifizieren. Sie können mehrere Schlüssel erstellen, jeden einzelnen auf Nur-Lese- oder Lese-/Schreibzugriff beschränken und jeden Schlüssel unabhängig widerrufen, ohne die anderen zu beeinflussen.
Typische Verwendungszwecke: Verbinden benutzerdefinierter Skripte, Übertragen von Gerätedaten in externe Dashboards oder Erstellen von Integrationen, die nicht durch die integrierten Konnektoren von Level abgedeckt werden.
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 Dialogfeld öffnet sich.
Geben Sie eine Beschreibung — etwas Spezifisches genug, damit Sie auch noch Monate später wissen, wofür dieser Schlüssel gedacht ist. „Inventar-Synchronisierung" oder „ConnectWise benutzerdefinierte Integration" ist hilfreicher als „API-Schlüssel 1".
Wählen Sie eine Zugriffsebene aus:
Lesen und Schreiben — kann Daten anzeigen sowie Datensätze erstellen, aktualisieren oder löschen
Nur lesen — kann Daten anzeigen, aber keine Datensätze erstellen, aktualisieren oder löschen
Klicken Sie auf Schlüssel erstellen.
💡 TIPP: Verwenden Sie den Nur-Lese-Zugriff für Integrationen, die nur Daten abrufen müssen (Reporting-Tools, externe Dashboards). Reservieren Sie Lese-/Schreibzugriff für Integrationen, 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 sichtbaren Zeichen zur Identifikation
Beschreibung — die Bezeichnung, die Sie bei der Erstellung vergeben haben
Zugriff — Lesen & Schreiben oder Nur lesen
Zuletzt verwendet — Zeitstempel der letzten authentifizierten Anfrage oder
--falls nie verwendetErstellt — Zeitpunkt der Schlüsselerstellung
Klicken Sie auf das Drei-Punkte-Menü am Ende einer Zeile, um:
Schlüssel kopieren — kopiert die maskierte Schlüsselkennung in Ihre Zwischenablage (nicht den vollständigen Geheimwert)
Bearbeiten — Beschreibung aktualisieren oder Zugriffsebene ändern
Löschen — den Schlüssel dauerhaft widerrufen
Einen Schlüssel bearbeiten
Klicken Sie auf Bearbeiten aus dem Drei-Punkte-Menü. Das API-Schlüssel aktualisieren Dialogfeld öffnet sich mit der aktuellen Beschreibung und Zugriffsebene als Vorausfüllung.
ℹ️ HINWEIS: Das Bearbeiten eines Schlüssels ändert nicht den Schlüsselwert selbst. Jede Integration, die diesen Schlüssel bereits verwendet, funktioniert weiterhin — sie übernimmt die neue Zugriffsebene sofort.
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 erfolgt 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ü bei einem beliebigen Schlüssel 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/Schreiben? Nur-Lese-Schlüssel können Daten aus der API abrufen, aber keine Änderungen vornehmen. Lese-/Schreibschlüssel können Datensätze erstellen, aktualisieren und löschen. Verwenden Sie die minimal erforderliche Zugriffsebene, die Ihre Integration tatsächlich benötigt.
Wer kann API-Schlüssel erstellen und verwalten? Techniker mit Zugriff auf die Einstellungen. Siehe Arbeitsbereich → Berechtigungen für Details zu rollenbasierten Zugriffskontrollen.
Eine Integration funktioniert nicht mehr, nachdem ich einen Schlüssel bearbeitet habe. Warum? Die Änderung der Zugriffsebene von Lesen/Schreiben auf Nur lesen tritt sofort in Kraft. 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 die einzige Kennung — Level protokolliert nicht, welches System eine bestimmte API-Anfrage mit einem Schlüssel gestellt hat. Verwenden Sie aussagekräftige Namen bei der Erstellung, damit Sie Schlüssel später den entsprechenden Integrationen zuordnen können.