Entwickler

Bau dein eigenes BoilerBuddy

Lies deine Solaranlage mit deiner eigenen Hardware aus und schick die Messwerte an BoilerBuddy. Dann hast du das ganze Portal dazu: Diagramme, Meldungen und Teilen. Die BoilerBuddy Alpo nutzt dieselbe API.

Basis-URL, API v1

https://boilerbuddy.eu/api/v1

API-Referenz OpenAPI-Spezifikation

OpenAPI 3.1 als YAML. Öffne sie in Swagger UI, Postman oder deinem eigenen Codegenerator. Diese Datei ist der Vertrag: Was darin steht, macht der Server.

API

Vier Endpunkte

Mehr brauchst du nicht, um ein Gerät zu koppeln und Messwerte zu senden.

POST/device/hello
Koppeln. Dein Gerät bekommt einen Kopplungscode zum Anzeigen und nach dem Koppeln einmalig sein Token.
GET/device/config
Welche Sensoren dein Gerät sendet und wie oft. Mit ETag, also günstig abzufragen.
POST/device/readings
Messwerte in Paketen bis 1000, jeder mit eigenem Zeitpunkt. Doppelt senden schadet nicht.
POST/device/status
Ein Heartbeat, damit das Portal erkennt, ob dein Gerät offline ist oder nur still.

Authentifizierung

Jede Anfrage außer hello trägt ein Token im Authorization-Header. Das Token bekommst du durch Koppeln mit einem Code, oder du legst es im Portal bei deinem Gerät an. Du siehst es nur einmal, also bewahre es gut auf.

Authorization: Bearer bb_live_…

Gut zu wissen

Zeiten in ISO 8601 mit Zeitzone. Der Server speichert UTC.
Ein wohlgeformtes Paket bekommt immer 200, auch wenn einzelne Messwerte abgelehnt werden. Die Antwort sagt pro Messwert, warum.
Pro Gerät 60 Anfragen pro Minute, davon höchstens 10 mit Messwerten. Bei 429 so lange warten, wie Retry-After sagt.
Lokal puffern und später nachsenden: Messwerte bis zu einem Jahr alt werden angenommen.

Dein erster Messwert

So sendest du mit curl eine Kollektortemperatur. Der Sensorcode (hier T1) steht in der Konfiguration deines Geräts.

Anfrage

curl -X POST \
  https://boilerbuddy.eu/api/v1/device/readings \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "batch_uuid": "0d4f6c1e-8a51-4c43-9b6b-3c1f0f7a2e11",
    "readings": [{
      "sensor": "T1",
      "value": 61.4,
      "measured_at": "2026-10-08T11:59:00Z"
    }]
  }'

Antwort · 200 OK

{
  "accepted": 1,
  "duplicates": 0,
  "unmapped": [],
  "rejected": []
}

Anleitungen und Beispiele

Ein Gerät koppeln, Messwerte zuverlässig senden und mit einer Uhr umgehen, die noch nicht synchron läuft. Mit vollständigen Beispielen.

Kommst du nicht weiter?

Fragen zur API oder zu einem Regler, den du anschließen willst? Sag uns Bescheid.

Kontakt aufnehmen