recipe

Method: GET POST
Version: v1
Return recipe data

There is additional return information that can be returned with a special agreement, these are:
  • Product ID of the ingredients, if this has to be matched with a list of ingredients.
  • Pregnancy suitable, see also the search filter "suitable_for_pregnancy".
  • FullHD Preview, adds a 1920px preview graphic on the long side (without watermark)

Table of contents

# Params

Params Default Description
id
Required
integer
 
recipe id
language
string
de-de
Language parameter like "de-de"

You can determine the allowed languages using the method get-languages.
fields
array
 
To return extra information.

Allowed Values:
  • allergens
  • diets
  • ingredients
  • steps
  • substances
scaled_portions
array
 
To calculate recipe and portion values to a limit of an substance value. This option required a special contract with us. For more information contact us.

Multi-dimensional array, sample:
energy kcal => 400
JSON: "scaled_portions":{"energy kcal": 400}

Allowed substances:
  • energy kcal
show_ingredients_in_base_unit
boolean|string
 
If activated, the ingredients are additionally returned in the basic units ml and g.
Sample: 1 tsp Sugar
{"quantity1": 1,"unit_short": "tsp","product": "Sugar","based_unit": {"quantity1": 6,"quantity2": "","unit": "g"}}

JSON: {"show_ingredients_in_base_unit": true}

This option required a special contract with us. For more information contact us.

# Headers

Authorization: Bearer {YOUR-JWT-TOKEN}

# Request

Ein Beispiel für die Erstellung eines JWT Tokens findest du hier: https://developer.cookbutler.com#jwt-token-sample

curl -X GET https://api.cookbutler.com/v1/recipes/recipe -H "Authorization: Bearer {YOUR-JWT-TOKEN}"

# Response

{ "status": "ok", "data": { "language": "de-de", "recipe": { "id_recipe": 70, "images": [], "create": "2019-01-01 00:00:00", "last_update": "2019-04-11 12:51:40", "title": "Zitronenkuchen nach italienischer Art", "subtitle": "", "serving": 6, "yield_quantity_1": 1, "yield_quantity_2": "", "yield_info": "Tarteform", "difficulty": "mittel" }, "ingredients": [ { "part_number": 1, "part_text": "F\u00fcr den Boden", "product": "Butter", "quantity1": 125, "quantity2": "", "item_attribute": "", "item_addition": "", "unit": "Gramm", "unit_short": "g" }, { "part_number": 1, "part_text": "F\u00fcr den Boden", "product": "Eigelb", "quantity1": 1, "quantity2": "", "item_attribute": "", "item_addition": "", "unit": "", "unit_short": "" }, { "...": "and more" } ], "steps": [ { "step_number": "1", "step_text": "Das Mehl mit Zucker auf die Arbeitsfl\u00e4che h\u00e4ufeln, mit Salz mischen und in die Mitte des Mehls eine Mulde dr\u00fccken. Die kalte Butter in kleine St\u00fccke schneiden, in die Mulde geben, das Eigelb in die Mitte geben, ca. 2-3 EL lauwarmes Wasser zugeben und s\u00e4mtliche Zutaten mit dem Messer gut durchhacken, so dass kleine Teigkr\u00fcmel entstehen." }, { "step_number": "2", "step_text": "Mit den H\u00e4nden rasch zu einem Teig verkneten, zu einer Kugel formen, in Frischhaltefolie wickeln und ca. 30 Minuten im K\u00fchlschrank k\u00fchl stellen." }, { "...": "and more" } ] } }