API-Schlüssel ermöglichen es externen Tools und Skripts, sich bei der Level-API zu authentifizieren. Sie können mehrere Schlüssel erstellen, jeden auf schreibgeschützten oder Lese- und Schreibzugriff beschränken und jeden Schlüssel unabhängig widerrufen, ohne die anderen zu beeinträchtigen.
Typische Anwendungen: Verbindung benutzerdefinierter Skripts, Abruf von Gerätedaten in externe Dashboards oder Erstellung von Integrationen, die nicht durch Level's integrierte Konnektoren abgedeckt sind.
Erstellen eines API-Schlüssels
Navigieren Sie zu Einstellungen → API-Schlüssel und klicken Sie dann oben rechts auf + API-Schlüssel erstellen.
Das Modal API-Schlüssel erstellen öffnet sich.
Geben Sie eine Beschreibung ein – etwas Spezifisches genug, dass Sie wissen, wofür dieser Schlüssel in Monaten bestimmt ist. "Bestandssynchronisierung" oder "ConnectWise-benutzerdefinierte Integration" ist nützlicher als "API-Schlüssel 1".
Wählen Sie eine Zugriffsstufe:
Lesen und schreiben – kann Daten anzeigen und Datensätze erstellen, aktualisieren oder löschen
Schreibgeschützt – kann Daten anzeigen, aber nicht erstellen, aktualisieren oder löschen
Klicken Sie auf Schlüssel erstellen.
💡 TIPP: Verwenden Sie schreibgeschützten Zugriff für Integrationen, die nur Daten abrufen müssen (Reporting-Tools, externe Dashboards). Reservieren Sie Lese- und Schreibzugriff für Integrationen, die Änderungen vornehmen müssen.
Verwaltung vorhandener Schlüssel
Die Seite API-Schlüssel listet alle Schlüssel Ihrer Organisation auf. Jede Zeile zeigt:
API-Schlüssel – maskierter Wert mit den letzten Zeichen sichtbar zur Identifikation
Beschreibung – das Etikett, das Sie bei der Erstellung zugewiesen haben
Zugriff – Lesen & schreiben oder Schreibgeschützt
Zuletzt verwendet – Zeitstempel der letzten authentifizierten Anfrage oder
--wenn nie verwendetErstellt – wann der Schlüssel generiert wurde
Klicken Sie auf das Drei-Punkte-Menü am Ende einer Zeile, um:
Schlüssel kopieren – kopiert die maskierte Schlüssel-ID in Ihre Zwischenablage (nicht den vollständigen geheimen Wert)
Bearbeiten – Beschreibung aktualisieren oder Zugriffsstufe ändern
Löschen – Schlüssel dauerhaft widerrufen
Bearbeiten eines Schlüssels
Klicken Sie auf Bearbeiten im Drei-Punkte-Menü. Das Dialog API-Schlüssel aktualisieren öffnet sich mit der aktuellen Beschreibung und Zugriffsstufe vorausgefüllt.
ℹ️ HINWEIS: Das Bearbeiten eines Schlüssels ändert nicht den Schlüsselwert selbst. Jede Integration, die diesen Schlüssel bereits verwendet, funktioniert weiterhin – sie erhält sofort die neue Zugriffsstufe.
Löschen eines Schlüssels
Klicken Sie auf Löschen im 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 von Schlüsseln ist sofort und dauerhaft. Aktualisieren Sie alle Integrationen, die den Schlüssel verwenden, bevor Sie ihn löschen, oder erwarten Sie, dass sie fehlschlagen.
Schlüssel durchsuchen
Verwenden Sie die Such-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 sehen? Ja. Klicken Sie auf das Drei-Punkte-Menü auf 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 Sie brauchen – einer pro Integration ist eine vernünftige Praxis, da Sie einzelne Integrationen widerrufen können, ohne andere zu beeinträchtigen.
Was ist der Unterschied zwischen schreibgeschützt und lesen-schreiben? Schreibgeschützte Schlüssel können Daten aus der API abrufen, können aber keine Änderungen vornehmen. Lese-Schreib-Schlüssel können Datensätze erstellen, aktualisieren und löschen. Verwenden Sie die minimale Zugriffsstufe, die Ihre Integration tatsächlich benötigt.
Wer kann API-Schlüssel erstellen und verwalten? Techniker mit Zugriff auf Einstellungen. Unter Arbeitsbereich → Berechtigungen finden Sie weitere Details zu rollengestützten Zugriffsbeschränkungen.
Eine Integration hat nach dem Bearbeiten eines Schlüssels nicht mehr funktioniert. Warum? Das Ändern der Zugriffsstufe von Lese-Schreib auf Schreibgeschützt wird sofort wirksam. Wenn sich die Integration auf Schreibzugriff verlässt, 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 sehen, welche Integration welchen Schlüssel verwendet? Das Feld Beschreibung ist der einzige Identifikator – Level protokolliert nicht, welches System eine bestimmte API-Anfrage gegen einen Schlüssel gestellt hat. Verwenden Sie beschreibende Namen bei der Erstellung, damit Sie später Schlüssel Integrationen zuordnen können.