Zum Hauptinhalt springen

Einstellungen für API-Schlüssel

Generate and manage API keys to authenticate external tools and integrations with Level's API.

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 Lese- oder Lese-/Schreibzugriff beschränken und jeden Schlüssel unabhängig widerrufen, ohne die anderen zu beeinflussen.

Typische Anwendungsfälle: Verbinden benutzerdefinierter Skripte, Übertragen 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-Agents verwendet. Um ein Gerät zu registrieren, verwenden Sie den Installationsschlüssel von Neues Gerät hinzufügen auf der Geräteliste – 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.

API Key Settings

Das API-Schlüssel erstellen Dialogfeld wird geöffnet.

API Key Modal
  1. Geben Sie eine Beschreibung — etwas Konkretes genug, damit Sie auch noch Monate später wissen, wofür dieser Schlüssel gedacht ist. „Inventar-Synchronisierung" oder „ConnectWise benutzerdefinierte Integration" ist nützlicher als „API-Schlüssel 1".

  2. Wählen Sie eine Zugriffsebene:

    • Lesen und Schreiben — kann Daten einsehen sowie Einträge erstellen, aktualisieren oder löschen

    • Nur-Lese — kann Daten einsehen, aber keine Einträge erstellen, aktualisieren oder löschen

  3. Klicken Sie auf Schlüssel erstellen.

💡 TIPP: Verwenden Sie Nur-Lese-Zugriff für Integrationen, die nur Daten abrufen müssen (Reporting-Tools, externe Dashboards). Behalten Sie Lese-/Schreibzugriff für Integrationen vor, die Änderungen vornehmen müssen.


Vorhandene Schlüssel verwalten

Die API-Schlüssel -Seite listet alle Schlüssel für Ihre Organisation auf. Jede Zeile zeigt:

  • API-Schlüssel — maskierter Wert, bei dem die letzten Zeichen zur Identifikation sichtbar sind

  • Beschreibung — die Bezeichnung, die Sie bei der Erstellung vergeben haben

  • Zugriff — Lesen & Schreiben oder Nur-Lese

  • Zuletzt verwendet — Zeitstempel der letzten authentifizierten Anfrage, oder -- wenn nie verwendet

  • Erstellt — Zeitpunkt der Schlüsselerstellung

Klicken Sie auf das Drei-Punkte-Menü am Ende einer beliebigen Zeile, um:

  • Schlüssel kopieren: kopiert den vollständigen API-Schlüsselwert in die Zwischenablage

  • 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 Dialogfeld ö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 — 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 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ü bei einem beliebigen Schlüssel und wählen Sie Schlüssel kopieren um den vollständigen Schlüsselwert jederzeit in die 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-Lese und Lesen/Schreiben? Nur-Lese-Schlüssel können Daten aus der API abrufen, aber keine Änderungen vornehmen. Lese-/Schreib-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 rollenbasierten Zugriffskontrollen.

  • Eine Integration funktioniert nicht mehr, nachdem ich einen Schlüssel bearbeitet habe. Warum? Das Ändern der Zugriffsebene von Lesen/Schreiben auf Nur-Lese 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 über einen Schlüssel gestellt hat. Verwenden Sie aussagekräftige Namen bei der Erstellung, damit Sie Schlüssel später Integrationen zuordnen können.

Hat dies deine Frage beantwortet?