Spécification BeerXML
Samovar accepte le format BeerXML 1.0 utilisé par les logiciels de brassage courants.
Format
- Racine RECIPES, puis un ou plusieurs enregistrements RECIPE avec HOPS, FERMENTABLES, YEASTS, MISCS, WATERS et un MASH facultatif.
- Les quantités utilisent les unités de base BeerXML : kilogrammes, litres, degrés Celsius et minutes.
- L’import du portail accepte une recette par envoi ; les enregistrements supplémentaires du même document sont ignorés.
Exemple
Chaque recette du catalogue est un exemple fonctionnel, par exemple 10 Heads High. Télécharger le BeerXML · Voir la recette
Fichiers et API
| Méthode | Chemin et paramètres | Réponse |
|---|---|---|
| GET | /recipes?q&catalog&family&styleType&recipeType&source&abvMin&abvMax&ibuMin&ibuMax&sort&page&perPage&lang | Résumés paginés des recettes publiques |
| GET | /recipes/{slug}?lang | Une recette publique au format JSON |
| GET | /recipes/{slug}/beerxml | Document BeerXML |
| GET | /calculators | Définitions des calculateurs |
| POST | /calculators/{code}/calculate JSON {"inputs":{}} | Résultats calculés |
Base de l’API publique : https://www.samovar-tool.ru/beerxml/v1/
Erreurs
400 cheesexml_validation_error, 401 cheesexml_unauthorized, 404 cheesexml_not_found, 405 cheesexml_method_not_allowed. Chaque erreur JSON contient les champs stables code et message.