Authentifizierung

Jede Anfrage an /v1 und an den MCP-Server braucht einen API-Schlüssel in der Kopfzeile Authorization:

GET /v1/organization HTTP/1.1
Host: api.ladehase.com
Authorization: Bearer lh_live_…

Test- und Liveschlüssel

Präfix	Daten	Zahlungen	Ladestationen
lh_test_	Testdaten (livemode: false)	Testzahlungen ohne echtes Geld	simulierte Testgeräte
lh_live_	Livedaten (livemode: true)	echte Zahlungen über zahls.ch oder Freika	deine verbundenen Ladestationen

Test- und Livedaten sind vollständig getrennt. Ein Testschlüssel sieht nie Livedaten und umgekehrt.

Schlüssel erstellen

Im Dashboard unter «Entwickler» erstellst du Schlüssel und gibst ihnen einen Namen, damit du sie später wiedererkennst. Der vollständige Schlüssel wird nur einmal angezeigt. Speichere ihn in einem Passwortmanager oder in den Umgebungsvariablen deiner Anwendung.

Ratenlimit

Pro Schlüssel gilt ein Limit pro Minute (Standard 600 Anfragen). Jede Antwort enthält die Kopfzeilen RateLimit-Limit, RateLimit-Remaining und RateLimit-Reset. Wird das Limit überschritten, antwortet die API mit 429 und dem Code rate_limited. Die Kopfzeile Retry-After sagt, wie viele Sekunden du warten sollst.

Organisationen

Ein Schlüssel gehört immer zu genau einer Organisation. Arbeitest du für mehrere Organisationen (zum Beispiel als Installateurin oder Installateur), erstellst du pro Organisation einen eigenen Schlüssel.

Fehler bei der Anmeldung

Status	Code	Bedeutung
401	unauthorized	Schlüssel fehlt, ist ungültig oder widerrufen.
403	forbidden	Der Schlüssel darf diese Aktion nicht ausführen oder die Funktion ist für die Organisation nicht freigeschaltet.