BrewForge Docs

API-Token

API-Token für REST-API, Actions-API und MCP-Server von BrewForge erstellen, umbenennen, ändern, neu erzeugen und löschen, mit Berechtigungen pro Token, und verbundene Apps trennen.

Mit API-Token können andere Programme deine BrewForge-Daten über die REST-API, die Actions-API und den MCP-Server lesen und ändern: eine Hausautomation, ein Tabellen-Skript, dein eigenes Dashboard, ein KI-Assistent. Du verwaltest sie unter Einstellungen → Integrationen → API-Token.

Pro-Tarif

Für den API-Zugriff brauchst du mindestens den Pro-Tarif. Token kannst du in jedem Tarif anlegen, API-Anfragen werden aber nur angenommen, solange dein Konto mindestens Pro hat.

Die Seite API-Token

Die Seite listet deine Token mit Name, den ersten Zeichen des Tokens, der Zahl der Berechtigungen, wann sie erstellt und zuletzt benutzt wurden und wann sie ablaufen. API nutzen darunter klappt Basis-URL, Header, Rate-Limits und den nötigen Tarif auf. In einem Tarif ohne API steht darüber eine Zeile dazu.

Verbundene Apps zwischen den Token und API nutzen listet die KI-Assistenten und anderen Apps, die du per OAuth-Anmeldung statt mit einem Token verbunden hast, mit der MCP-Server-URL zum Kopieren. Klick eine App an, um sie zu trennen. Wie du eine verbindest: MCP-Server.

Ein Token erstellen

Öffne Einstellungen, wechsle zu Integrationen, klicke auf API-Token und dann auf Token erstellen.

Der Dialog Token erstellen

Gib unter Name an, wo es verwendet wird, zum Beispiel „Home Assistant“.

Hake unter Darf zugreifen auf die Berechtigungen an, die das Programm braucht, und nicht mehr. Lese-Berechtigungen (read) listen nur Daten auf, Schreib-Berechtigungen (write) können sie anlegen, ändern und löschen.

Klicke auf Token erstellen und kopiere das Token aus Kopiere dein Token. Es wird nur einmal angezeigt. Wenn du es verlierst, erzeugst du es neu.

Berechtigungen

BerechtigungErlaubt
readAlles lesen (alle Bereiche)
writeAlles anlegen, ändern und löschen (alle Bereiche)
brews:readSude auflisten und ansehen
brews:writeSude und Notizen anlegen, ändern, löschen
inventory:readBestandsartikel auflisten
inventory:writeBestandsartikel anlegen, ändern, löschen
cellar:readKeller, abgefüllten Bestand, Taplists und Etiketten ansehen
cellar:writeKeller, Abfüllung, Bestand, Taplists und Etiketten verwalten
profiles:readMaisch-, Gär- und Wasserprofile auflisten
profiles:writeMaisch-, Gär- und Wasserprofile anlegen, ändern, löschen
equipment:readAnlagenprofile auflisten
equipment:writeAnlagenprofile anlegen, ändern, löschen
styles:readBierstilprofile auflisten
styles:writeBierstilprofile anlegen, ändern, löschen
custom-fields:readDefinitionen eigener Felder auflisten
custom-fields:writeDefinitionen eigener Felder anlegen, ändern, löschen
settings:readEinstellungen, Importe, Rechner und Datenexport ansehen
settings:writeEinstellungen ändern und Importe rückgängig machen
community:readCommunity, Feedback, Tickets, Posteingang und Kontoübersicht ansehen
community:writeIn Community, Feedback und Tickets schreiben, abstimmen und antworten

read und write gelten für alle Bereiche, auch für künftige. Eine Schreib-Berechtigung enthält das Lesen nicht: Hake beide an, wenn ein Programm liest und schreibt. Unter Authentifizierung steht, welche Daten jeder Bereich umfasst, und die Tool-Referenz nennt die Berechtigung jeder Action.

Ein Token ändern, neu erzeugen oder löschen

Klicke ein Token an, um es zu öffnen:

  • Ändere den Namen oder worauf es zugreifen darf und klicke auf Speichern. Der Token-Wert bleibt gleich, Programme arbeiten also mit den neuen Berechtigungen weiter.
  • Neu erzeugen… erstellt nach einer Warnung, die du bestätigst, einen neuen Token-Wert und widerruft den alten sofort. Programme mit dem alten Wert funktionieren erst wieder, wenn du ihnen den neuen gibst.
  • Token löschen widerruft das Token nach einer Bestätigung sofort.

Das Token verwenden

Schicke das Token bei jeder Anfrage im Header Authorization mit:

curl https://brewforge.sh/api/v1/brews \
  -H "Authorization: Bearer YOUR_TOKEN"

Details stehen unter Authentifizierung, Rate-Limits und in der API-Referenz (auf Englisch).

Auf dieser Seite