Zeichne jeden Sensor auf, der HTTP spricht.
Ordne die Felder deiner eigenen Payload Extrakt, Temperatur, Druck, pH, Gewicht oder Volumen zu. BrewForge liest jede Anfrage mit deiner Zuordnung aus und fügt die Messwerte dem Sud hinzu, mit dem das Gerät verbunden ist.
{
"sensor": "fv2-probe",
"data": {
"sg": 1.0142,
"temp_f": 50.4,
"psi": 12.3
},
"ts": 1792680000
}Deine Payload, Feld für Feld zugeordnet
Wähle das Payload-Format und ordne dann einen Quellpfad einem Feld in BrewForge zu. Verschachteltes JSON nutzt Punktpfade wie data.sg. Füge eine Beispiel-Payload in Test Parse ein und sieh vor dem Speichern genau, was BrewForge ausliest.
- JSON, Query-Parameter oder Formular (URL-encoded)
- Extrakt, Temperatur, Akku, Neigungswinkel, RSSI, pH, Druck, Gewicht, Volumen und Zeitstempel
- Einheiten werden umgerechnet: °Plato und °Brix in SG, °F und K in °C, bar und kPa in PSI, Gramm, Unzen und Pfund in kg, mL und Gallonen in Liter
- Oder lies die Einheit aus einem anderen Feld der Payload
Druck, pH und Keg-Waagen
Messwerte mit einem Extraktwert landen im Gärverlauf des verbundenen Suds, zusammen mit Temperatur, pH und Druck, wenn deine Payload sie enthält.
Ein Datenstrom, der Gewicht oder Volumen zuordnet, kann stattdessen ein Keg messen: Verbinde ihn im Keller mit einem Keg, und die Restmenge bleibt aktuell. Der Keller ist Teil von Pro; alles andere auf dieser Seite funktioniert in jedem Plan.
In drei Schritten eingerichtet
Der Geräte-Key ist geheim: Jeder mit der URL kann Messwerte an dieses Gerät senden. Halte ihn aus öffentlichen Code-Repositories heraus.
Suchst du stattdessen die REST-API, um Sude, Bestand und Profile zu lesen und zu schreiben? Zur API-Doku (auf Englisch).
- 1Gerät vom Typ Custom Stream anlegenÖffne Devices → Add Device, wähle Custom Stream und klicke auf Configure Schema. Wähle das Payload-Format, ordne deine Felder zu, prüfe sie mit Test Parse und lege das Gerät an.
- 2Messwerte an die Webhook-URL sendenSchick jeden Messwert per POST (oder PUT) an die Webhook-URL. Lass
?key=…in der URL oder sende den Key alsAuthorization: Bearer. Payloads dürfen bis zu 64 KB groß sein. - 3Mit einem Sud verbindenNutze Attach to Brew im Gerätemenü oder verbinde das Gerät im Tab „Fermentation“ deines Suds.
https://brewforge.sh/api/devices/webhook?key=3f9c2a7e-…curl -X POST "https://brewforge.sh/api/devices/webhook" \
-H "Authorization: Bearer $DEVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"data":{"sg":1.0142,"temp_f":50.4,"psi":12.3},"ts":1792680000}'Beispiel-Payload
Mit der Zuordnung oben liest BrewForge data.sg als Extrakt, rechnet data.temp_f von °F in °C um, speichert data.psi als Druck und nutzt ts als Zeitpunkt der Messung. Felder ohne Zuordnung werden ignoriert.
Die Antwort zeigt dir, was ausgelesen wurde – so kannst du neue Firmware von der Kommandozeile aus prüfen, bevor du sie laufen lässt.
{
"sensor": "fv2-probe",
"data": {
"sg": 1.0142,
"temp_f": 50.4,
"psi": 12.3
},
"ts": 1792680000
}Wenn keine Messwerte ankommen
- Nutze Send Test unter Recent Data am Gerät, um eine Beispiel-Payload zu senden und das Ergebnis zu sehen.
- Ein
401heißt: Der Key fehlt oder ist falsch. Kopiere die komplette Webhook-URL oder sende den Key als Bearer-Token – nicht beides mit unterschiedlichen Werten. - Ein
400mit JSON-Parse-Fehler heißt: Der Body ist kein gültiges JSON für einen JSON-Datenstrom. - Felder bleiben leer: Prüfe die Quellpfade mit Test Parse gegen deine Payload, inklusive Punktpfaden für verschachtelte Objekte.
- Messwerte kommen an, aber nicht in deinem Sud: Verbinde das Gerät mit dem Sud. Nur Messwerte mit einem Extraktwert landen im Gärverlauf.
Eigene Datenströme funktionieren in jedem Plan: Kostenlos (bis zu 20 Sude), Basic und Pro. Keg-Sensoren im Keller brauchen Pro.
Pläne vergleichenFAQ
Fragen zum eigenen Webhook
Welche Geräte kann ich über einen eigenen Datenstrom anbinden?
Alles, was eine HTTP-Anfrage senden kann: einen DIY-Sensor mit ESP32 oder ESP8266, einen Drucksensor, eine Keg-Waage, einen Node-RED-Flow oder eine Home-Assistant-Automatisierung. Wenn es JSON, Query-Parameter oder Formularfelder per POST senden kann, kannst du es zuordnen.
Wie authentifiziert sich das Gerät?
Mit dem Geräte-Key, den BrewForge dafür erzeugt. Lass ihn entweder als ?key=… in der Webhook-URL oder sende ihn als Header Authorization: Bearer.
Kann ich den Zeitpunkt einer Messung mitschicken?
Ja. Ordne ein Payload-Feld dem Zeitstempel (Unix-Sekunden) zu oder häng ×tamp=<Unix-Sekunden> an die Webhook-URL an. BrewForge speichert trotzdem höchstens etwa alle 15 Minuten einen Messwert pro Gerät – zum Nachladen vieler alter Messwerte auf einmal ist das also nicht gedacht.
Ist der eigene Datenstrom im kostenlosen Plan enthalten?
Ja. Geräte, auch eigene Datenströme, kannst du in jedem Plan verbinden. Eine Keg-Waage oder einen Volumensensor mit einem Keg zu verbinden, nutzt den Keller, und der ist Teil von Pro.
Dein nächster Sud beginnt hier.
Kostenlos für bis zu 20 Sude. Ohne Kreditkarte.