BrewForge Docs

Gerät hinzufügen

Lege ein Gerät in BrewForge in drei Schritten an (Gerätetyp, Name, Verbinden) und trag seine Webhook-URL in deiner Spindel, Bridge oder deinem Sensor ein.

Gerät hinzufügen auf der Seite Geräte öffnet einen Dialog mit drei Schritten. Die Schrittleiste oben zeigt, wo du gerade bist; Zurück führt zum vorigen Schritt.

Gerät. Wähl den Typ, der dazu passt, wie dein Gerät Daten sendet. Jeder Typ hat eine kurze Beschreibung, damit du zum Beispiel einen einzelnen Tilt von einer Tilt Bridge unterscheiden kannst. Klick auf Weiter.

Gerät hinzufügen, Schritt 1: die Gerätetypen mit je einer kurzen Beschreibung

Name. Gib dem Gerät einen Namen, an dem du es wiedererkennst, zum Beispiel iSpindel Grün oder Roter Tilt. Er ist nur in BrewForge sichtbar. Bei einem Eigenen Datenstrom heißt der Schritt Name & Zuordnung, und du legst zusätzlich fest, welche Felder der Payload BrewForge liest (Eigener Datenstrom). Klick auf Gerät anlegen.

Verbinden. Das Gerät ist jetzt angelegt. BrewForge zeigt seine Webhook-URL mit einem Kopier-Button, die nummerierten Einrichtungsschritte für den Gerätetyp und bei einer RAPT Pill die Payload zum Einfügen. Kopier die URL in dein Gerät.

Gerät hinzufügen, Schritt 3: die Webhook-URL und die Einrichtungsschritte für die iSpindel, wartet auf den ersten Messwert

Unten steht, dass der Dialog auf den ersten Messwert wartet. Warten musst du nicht: Schließ ihn mit Fertig oder klick auf Geräteseite öffnen, um direkt zur Geräteseite zu gehen. URL und Einrichtungsschritte stehen auch dort.

Klappt das Anlegen nicht, sagt der Dialog, dass nichts gespeichert wurde, und der Button heißt Erneut versuchen.

Gerätetypen

Wähl den Typ, der dazu passt, wie dein Gerät Daten sendet, denn BrewForge liest das Datenformat jedes Typs anders:

TypWofürAnleitung
iSpindelEine WLAN-Spindel, die über HTTP sendetiSpindel
Tilt HydrometerEin Tilt über eine TiltBridge oder einen TiltPiTilt
Tilt BridgeMehrere Tilts über eine TiltBridge oder einen TiltPi; jede Farbe wird ein eigenes GerätTilt
RAPT PillEine Pill über einen RAPT-Cloud-WebhookRAPT Pill
HydromDer HTTP-Client-Dienst des HydromHydrom
GravityMonDer HTTP-Post-Push von GravityMon im iSpindel-FormatGravityMon
BrewBrain FloatEin Geräte-Token statt einer URL; funktioniert noch nichtBrewBrain Float
Plaato AirlockBlasen pro Minute und Temperatur, über einen Community-Server (open-plaato-keg)Plaato Airlock
Eigener DatenstromJedes Gerät, das JSON, Query-Parameter oder ein Formular sendet, auch FasswaagenEigener Datenstrom

Den Typ kannst du später nicht ändern. Hast du den falschen gewählt, lösch das Gerät und leg es neu an.

Die Webhook-URL

Jedes Gerät bekommt eine eigene URL:

https://brewforge.sh/api/devices/webhook?key=YOUR_DEVICE_KEY

Der key identifiziert das Gerät und dein Konto. Behandle die URL wie ein Passwort: Wer sie hat, kann Messwerte an dein Gerät schicken. BrewForge nimmt den Schlüssel statt in der URL auch als Header an, was manche Tools bevorzugen:

Authorization: Bearer YOUR_DEVICE_KEY

Der Endpunkt nimmt POST- (und PUT-)Anfragen mit JSON- oder Formular-Body bis 64 KB an.

Um die URL wiederzufinden, öffne die Geräteseite: Einrichtung zeigt sie mit Kopier-Button, und im ⋯-Menü gibt es Webhook-URL kopieren. Eine BrewBrain Float zeigt stattdessen einen Geräte-Token.

Auf dieser Seite