Jede Anfrage an die blueplant-API braucht einen API-Schlüssel. Damit weist sich dein System gegenüber blueplant aus.
API-Schlüssel erstellen
Einstellungen öffnen
Klicke im Web-Programm in der linken Menüleiste auf Einstellungen.
API-Schlüssel erzeugen
Im Abschnitt API & Schnittstellen erzeugst du einen neuen Schlüssel. Kopiere ihn sofort und bewahre ihn sicher auf.
Den API-Schlüssel verwaltet die Rolle Verwaltung (siehe Wer darf was). Es gibt einen Schlüssel je Betrieb.
Schlüssel mitsenden
Sende den Schlüssel bei jeder Anfrage im Header ApiKey mit:
Ein API-Schlüssel ist wie ein Passwort und erlaubt Zugriff auf die in blueplant hinterlegten Daten. Gib ihn nur an vertrauenswürdige Systeme weiter und niemals in öffentlichen Code (z. B. im Browser).
Wenn du einen neuen Schlüssel erzeugst oder den vorhandenen löschst, wird der alte ungültig. Integrationen, die ihn nutzen, funktionieren dann nicht mehr.
Fehlermeldungen
Schlägt eine Anfrage fehl, antwortet die API mit einem dieser Status-Codes: