Спецификация BeerXML
«Самовар» принимает формат BeerXML 1.0, используемый распространёнными программами для пивоварения.
Формат
- Корневой элемент RECIPES, затем одна или несколько записей RECIPE с HOPS, FERMENTABLES, YEASTS, MISCS, WATERS и необязательным MASH.
- Величины указываются в базовых единицах BeerXML: килограммы, литры, градусы Цельсия и минуты.
- Импорт на портале принимает один рецепт за загрузку; лишние записи в том же документе игнорируются.
Пример
Каждый рецепт в каталоге — рабочий пример, например 10 Heads High. Скачать BeerXML · Открыть рецепт
Файлы и API
| Метод | Путь и параметры | Ответ |
|---|---|---|
| GET | /recipes?q&catalog&family&styleType&recipeType&source&abvMin&abvMax&ibuMin&ibuMax&sort&page&perPage&lang | Постраничные сводки публичных рецептов |
| GET | /recipes/{slug}?lang | Один публичный рецепт в JSON |
| GET | /recipes/{slug}/beerxml | Документ BeerXML |
| GET | /calculators | Определения калькулятора |
| POST | /calculators/{code}/calculate JSON {"inputs":{}} | Результаты расчёта |
Базовый адрес публичного API: https://www.samovar-tool.ru/beerxml/v1/