BeerXML-Spezifikation
Samovar akzeptiert das BeerXML-1.0-Format, das gängige Brausoftware verwendet.
Format
- Wurzelreihenfolge RECIPES, dann ein oder mehrere RECIPE-Einträge mit HOPS, FERMENTABLES, YEASTS, MISCS, WATERS und einem optionalen MASH.
- Mengen verwenden die BeerXML-Basiseinheiten: Kilogramm, Liter, Celsius und Minuten.
- Der Portalimport akzeptiert ein Rezept pro Upload; weitere Einträge im selben Dokument werden ignoriert.
Beispiel
Jedes Katalogrezept ist ein funktionierendes Beispiel, zum Beispiel 10 Heads High. BeerXML herunterladen · Rezept ansehen
Dateien und API
| Methode | Pfad und Parameter | Antwort |
|---|---|---|
| GET | /recipes?q&catalog&family&styleType&recipeType&source&abvMin&abvMax&ibuMin&ibuMax&sort&page&perPage&lang | Seitenweise öffentliche Rezeptübersichten |
| GET | /recipes/{slug}?lang | Ein öffentliches Rezept als JSON |
| GET | /recipes/{slug}/beerxml | BeerXML-Dokument |
| GET | /calculators | Rechnerdefinitionen |
| POST | /calculators/{code}/calculate JSON {"inputs":{}} | Berechnete Ergebnisse |
Öffentliche API-Basis: https://www.samovar-tool.ru/beerxml/v1/
Fehler
400 cheesexml_validation_error, 401 cheesexml_unauthorized, 404 cheesexml_not_found, 405 cheesexml_method_not_allowed. Jeder JSON-Fehler enthält die stabilen Felder code und message.