Einführung
API-Schlüssel ermöglichen es externen Tools und Skripten, sich bei Level's API zu authentifizieren. Sie können mehrere Schlüssel erstellen, jeden auf schreibgeschützten oder Lese-Schreib-Zugriff beschränken und jeden Schlüssel unabhängig widerrufen, ohne die anderen zu beeinflussen.
Typische Verwendungen: Verbindung benutzerdefinierter Skripte, Abruf von Gerätedaten in externe Dashboards oder Erstellung von Integrationen, die nicht von Level's integrierten Konnektoren abgedeckt werden.
Creating an API Key
Navigate to Settings → API keys , then click + Create API key in the top right.
The Create API key modal opens.
Enter a Description — etwas Spezifisches, damit Sie in Monaten noch wissen, wofür dieser Schlüssel ist. "Inventory-Synchronisierung" oder "ConnectWise-benutzerdefinierte Integration" ist nützlicher als "API-Schlüssel 1."
Select an access level:
Read and write — können Daten anzeigen und Datensätze erstellen, aktualisieren oder löschen
Read-only — können Daten anzeigen, aber keine Datensätze erstellen, aktualisieren oder löschen
Click Create key .
💡 TIP: Verwenden Sie schreibgeschützten Zugriff für Integrationen, die nur Daten abrufen müssen (Reporting-Tools, externe Dashboards). Reservieren Sie Lese-Schreib für Integrationen, die Änderungen vornehmen müssen.
Managing Existing Keys
The API keys Seite listet alle Schlüssel für Ihre Organisation auf. Jede Zeile zeigt:
API key — maskierter Wert mit den letzten Zeichen sichtbar zur Identifizierung
Description — the label you assigned at creation
Access — Read & write or Read-only
Last usedZeitstempel der letzten authentifizierten Anfrage, oder
--if never usedCreated — when the key was generated
Klicken Sie auf das Drei-Punkte-Menü am Ende einer Zeile, um:
Copy key — kopiert die maskierte Schlüsselkennung in Ihre Zwischenablage (nicht den vollständigen Geheimniswert)
Edit — aktualisiert die Beschreibung oder ändert die Zugriffsstufe
Delete — permanently revoke the key
Editing a Key
Click Edit aus dem Drei-Punkte-Menü. DieUpdate API key Dialog ö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 übernimmt sofort die neue Zugriffsstufe.
Deleting a Key
Click Delete 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 von Schlüsseln ist sofort und dauerhaft. Aktualisieren Sie alle Integrationen, die den Schlüssel verwenden, vor dem Löschen, oder erwarten Sie, dass sie fehlschlagen.
Searching Keys
Use the Search Balken 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 SieCopy key um den vollständigen Schlüsselwert jederzeit in Ihre Zwischenablage zu kopieren.
How many API keys can I create? Erstellen Sie so viele wie nötig — einer pro Integration ist eine angemessene Vorgehensweise, da Sie einzelne Integrationen widerrufen können, ohne andere zu beeinflussen.
Was ist der Unterschied zwischen schreibgeschützt und Lese-Schreib? 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.
Who can create and manage API keys? Techniker mit Zugriff auf Einstellungen. SieheArbeitsbereich → Berechtigungen für Details zu rollenbasierten Zugriffskontroller.
Eine Integration funktionierte nicht mehr, nachdem ich einen Schlüssel bearbeitet habe. Warum? Das Ändern der Zugriffsstufe von Lese-Schreib auf schreibgeschützt wird sofort wirksam. Wenn die Integration auf Schreibzugriff angewiesen war, wird sie bei allen Anfragen fehlschlagen, die versuchen, Daten zu erstellen, zu aktualisieren oder zu löschen. Überprüfen Sie die Fehlerprotokolle der Integration auf 403-Antworten.
Kann ich feststellen, welche Integration welchen Schlüssel verwendet? Das Feld "Beschreibung" ist der einzige Identifikator — Level protokolliert nicht, welches System einen bestimmten API-Anfrage gegen einen Schlüssel gemacht hat. Verwenden Sie aussagekräftige Namen zum Zeitpunkt der Erstellung, um später Schlüssel mit Integrationen abgleichen zu können.