Testmodus

Mit einem Testschlüssel lh_test_… arbeitest du in einer vollständig getrennten Testumgebung. Ladestationen sind simuliert, Zahlungen laufen über eine Testzahlung. Ideal zum Ausprobieren, für automatisierte Tests und für KI-Agenten, die du zuerst gefahrlos üben lassen willst.

Testgeräte anlegen

curl -X POST https://api.ladehase.com/v1/integrations/test \
  -H "Authorization: Bearer lh_test_…"

Ladehase legt eine Testverbindung mit simulierten Ladepunkten an. Die Anfrage ist wiederholbar, bestehende Testgeräte bleiben erhalten.

Ein Auto simulieren

Mit POST /v1/devices/{id}/simulate steuerst du ein Testgerät. Erlaubte Aktionen:

Aktion	Wirkung
plug	Auto einstecken. Mit vehicle_need_wh legst du fest, wie viel Energie das Auto aufnimmt, bis es voll ist.
unplug	Kabel abziehen. Eine laufende Ladung endet mit dem Grund unplugged.
set_power	Ladeleistung ändern, in Watt mit power_w.
offline, online	Verbindung zur Ladestation trennen oder wiederherstellen.
error, clear_error	Störung auslösen oder beheben.

curl -X POST https://api.ladehase.com/v1/devices/dev_…/simulate \
  -H "Authorization: Bearer lh_test_…" \
  -H "Content-Type: application/json" \
  -d '{ "action": "plug", "vehicle_need_wh": 20000 }'

Testzahlungen

Scannst du im Testmodus den QR-Code eines Testladepunkts, öffnet die Bezahlseite eine Testzahlung. Dort wählst du, ob die Zahlung gelingt, fehlschlägt oder abgebrochen wird. So prüfst du alle Wege, ohne Geld zu bewegen.

Live schalten

Sobald du eine echte Ladestation und ein Konto bei zahls.ch oder Freika verbunden hast, nutzt du einen Liveschlüssel lh_live_…. Am Code ändert sich nichts ausser dem Schlüssel.