API-Schlüssel erstellen
API-Schlüssel ermöglichen den programmatischen Zugriff auf Ihre Messdaten. Sie sind auf bestimmte Berechtigungen (Scopes) einschränkbar und können jederzeit widerrufen werden.
Schlüssel erstellen
Es gibt zwei Wege, einen API-Schlüssel zu erstellen:
Weg 1 — direkt am Zähler:
- Öffnen Sie Zähler → [Zähler wählen] → API.
- Klicken Sie auf API-Schlüssel generieren.
- Der Schlüssel wird automatisch auf diesen Zähler eingeschränkt.
Weg 2 — im Profil (für breiteren Zugriff):
- Klicken Sie oben rechts auf Ihren Namen → Profil.
- Wechseln Sie zum Tab API Tokens.
- Klicken Sie auf Neuer Token, vergeben Sie einen Namen und wählen Sie Berechtigungen.
Schlüssel nur einmal sichtbar
Nach der Erstellung wird der vollständige Schlüssel nur einmal angezeigt. Kopieren Sie ihn sofort und speichern Sie ihn sicher — er kann danach nicht mehr eingesehen werden.
Haben Sie einen Schlüssel verloren, widerrufen Sie ihn und erstellen Sie einen neuen.
Berechtigungen (Scopes)
| Scope | Zugriff |
|---|---|
| read:measurements | Messwerte lesen |
| read:meters | Zählerdetails lesen |
Vergeben Sie nur die Berechtigungen, die eine Anwendung tatsächlich benötigt.
Schlüssel verwalten und widerrufen
Alle aktiven Schlüssel sind unter Profil → API Tokens aufgelistet. Dort sehen Sie Name, Erstellungsdatum und zuletzt verwendete Zeit.
Um einen Schlüssel zu widerrufen, klicken Sie neben dem Eintrag auf Widerrufen. Der Schlüssel wird sofort ungültig — laufende Anfragen, die diesen Schlüssel verwenden, erhalten ab diesem Zeitpunkt einen 401-Fehler.