Especificación de BeerXML
Samovar acepta el formato BeerXML 1.0 que usa el software de cerveza más habitual.
Formato
- Orden de raíz RECIPES y luego uno o más registros RECIPE con HOPS, FERMENTABLES, YEASTS, MISCS, WATERS y un MASH opcional.
- Las cantidades usan las unidades base de BeerXML: kilogramos, litros, Celsius y minutos.
- La importación del portal acepta una receta por carga; los registros adicionales del mismo documento se ignoran.
Ejemplo
Cada receta del catálogo es un ejemplo funcional, por ejemplo 10 Heads High. Descargar BeerXML · Ver la receta
Archivos y API
| Método | Ruta y parámetros | Respuesta |
|---|---|---|
| GET | /recipes?q&catalog&family&styleType&recipeType&source&abvMin&abvMax&ibuMin&ibuMax&sort&page&perPage&lang | Resúmenes públicos de recetas paginados |
| GET | /recipes/{slug}?lang | Una receta pública en JSON |
| GET | /recipes/{slug}/beerxml | Documento BeerXML |
| GET | /calculators | Definiciones de calculadoras |
| POST | /calculators/{code}/calculate JSON {"inputs":{}} | Resultados calculados |
Base de la API pública: https://www.samovar-tool.ru/beerxml/v1/
Errores
400 cheesexml_validation_error, 401 cheesexml_unauthorized, 404 cheesexml_not_found, 405 cheesexml_method_not_allowed. Todos los errores JSON contienen los campos estables code y message.