Zum Inhalt springen
Rezeptrechner

Rezepte V1

Als Markdown anzeigen

Dieses Objekt steht für ein Rezept in Rezeptrechner — ein Gericht oder Produkt mit Zutaten, Portionen, Nährwerten, Allergenen und Kennzeichnungsdaten. Damit listest du die Rezepte eines Tokens oder rufst ein einzelnes Rezept per ID ab.

Das Rezept-Objekt #

Felder, Enums und verschachtelte Strukturen der Rezept-Endpunkte.

Attribute

id string
Eindeutige Kennung des Rezepts.
name string
Rezepttitel.
identifier string
Interne Rezeptnummer / SKU, falls gesetzt.
categories string[]
Kategorien des Rezepts.
folders string[]
Ordnernamen, wenn Ordner-Zugriff vorhanden ist.
is_linked_to_ingredient boolean
true, wenn mindestens eine eigene Zutat auf dieses Rezept zeigt.
linked_ingredients object[]
Verknüpfte eigene Zutaten. Leer, wenn nicht verknüpft.
Unterattribute anzeigen Unterattribute ausblenden
id string
Eindeutige Kennung der Zutat.
name string
Zutatenname in Titelschreibweise.
is_dynamic boolean
true, wenn die verknüpfte Zutat ein dynamisches, rezeptgestütztes Element ist.
food_type string
Aggregatzustand, aus internem g / ml.

Mögliche Enum-Werte

solid

Festes Lebensmittel (interne g-Messung).

liquid

Flüssigkeit (interne ml-Messung).

portions object
Wie das Rezept portioniert ist.
Unterattribute anzeigen Unterattribute ausblenden
portion_name string
Bezeichnung einer Portion (z. B. Stück).
portion_count integer
Anzahl der Portionen.
portion_weight string
Gewicht einer Portion als String mit zwei Dezimalen.
portion_by_weight boolean
true, wenn Portionen nach Gewicht definiert sind.
reduction_factor number
Ausbeute- / Reduktionsfaktor des Rezepts.
ingredients object[]
Zutatenzeilen des Rezepts. Mengen und Gewichte als Dezimal-Strings.
Unterattribute anzeigen Unterattribute ausblenden
id string
Eindeutige Kennung der Zutat.
name string
Zutatentitel.
amount string
Menge als Dezimal-String.
unit string
Einheit der Menge (z. B. g).
weight string
Gewicht in Gramm als Dezimal-String.
mise_en_place string
Mise-en-place-Hinweis oder null.
type string
Quelle der Zeile.

Mögliche Enum-Werte

standard

Standard-Zutat.

bls

BLS-Zutat.

custom

Eigene Zutat.

is_linked boolean
true, wenn diese Zutatenzeile mit einem Quellrezept verknüpft ist.
is_dynamic boolean
true, wenn die verknüpfte Zutat live verknüpft (dynamisch) ist; false bei statischem Snapshot oder wenn die Zeile nicht verknüpft ist. Unterscheidet sich von is_linked_to_ingredient auf Rezeptebene.
ingredient_list string
Der Deklarationstext der Zutatenliste.
instructions object[]
Geordnete Klartext-Schritte.
Unterattribute anzeigen Unterattribute ausblenden
order integer
0-basierte Position des Schritts.
text string
Ein Schritt als Klartext.
preparation object
Arbeitsanweisungen, Geräte und Zeiten aus dem Seitenpanel.
Unterattribute anzeigen Unterattribute ausblenden
description string
Kurze Rezeptbeschreibung oder null.
serving_suggestion string
Serviervorschlag oder null.
side_dishes string
Beilagenvorschlag oder null.
required_equipment string
Benötigtes Gerät oder null.
utensils string
Utensilien oder null.
preparation_time_minutes integer
Aktive Zubereitungszeit in Minuten oder null.
waiting_time_minutes integer
Wartezeit in Minuten oder null.
cooking_time_minutes integer
Garzeit in Minuten oder null.
comments string
Kommentare als Klartext (HTML entfernt) oder null.
storage object
Lagerhinweise aus dem Seitenpanel.
Unterattribute anzeigen Unterattribute ausblenden
shelf_life_days integer
Haltbarkeit in Tagen oder null.
temperature_celsius number
Lagertemperatur in °C oder null.
storage_instructions string
Freitext-Lagerhinweise oder null.
packaging string
Verpackungshinweis oder null.
product object
Artikelnummer, Marke, Qualität, Herkunftsfelder und Klartext-Notizen.
Unterattribute anzeigen Unterattribute ausblenden
article_number string
Artikelnummer oder null.
brand string
Marke oder null.
quality string
Qualität oder null.
origin_type string
Herkunftstyp oder null.
product_origin string
Produktherkunft oder null.
product_notes string
Produktnotizen als Klartext oder null.
declaration_notice string
Deklarationshinweis oder null.
nutrition object
Gewichte als Dezimal-Strings und Nährstoffkarten mit snake_case-Schlüsseln.
Unterattribute anzeigen Unterattribute ausblenden
total_weight string
Gesamtrezeptgewicht als Dezimal-String.
portion_weight string
Portionsgewicht als Dezimal-String.
per_100g object
Nährstoffe pro 100 g.
Unterattribute anzeigen Unterattribute ausblenden
energy_kj number
Energie in kJ.
energy_kcal number
Energie in kcal.
fat number
Fett in Gramm.
saturated_fat number
Gesättigte Fettsäuren in Gramm.
carbs number
Kohlenhydrate in Gramm.
sugars number
Zucker in Gramm.
protein number
Eiweiß in Gramm.
salt number
Salz in Gramm.
fiber number
Ballaststoffe in Gramm.
alcohol number
Alkohol in Gramm.
per_portion object
Nährstoffe pro Portion.
Unterattribute anzeigen Unterattribute ausblenden
energy_kj number
Energie in kJ.
energy_kcal number
Energie in kcal.
fat number
Fett in Gramm.
saturated_fat number
Gesättigte Fettsäuren in Gramm.
carbs number
Kohlenhydrate in Gramm.
sugars number
Zucker in Gramm.
protein number
Eiweiß in Gramm.
salt number
Salz in Gramm.
fiber number
Ballaststoffe in Gramm.
alcohol number
Alkohol in Gramm.
allergens object[]
Deklarierte Allergene.
Unterattribute anzeigen Unterattribute ausblenden
code integer
Numerischer Allergen-Code.
name string
Englischer Allergenname.
additives object[]
Deklarierte Zusatzstoffe.
Unterattribute anzeigen Unterattribute ausblenden
code integer
Numerischer Zusatzstoff-Code.
name string
Englischer Zusatzstoffname.
food_tags object
Ernährungsform und Tierart, jedes Mal aus den Zutaten abgeleitet (Rezepte speichern sie nicht). Dieselbe Einordnung wie „Ernährungsform & Tierart“ in der Web-App.
Unterattribute anzeigen Unterattribute ausblenden
diet string
Ernährungsform des Rezepts. null nur, wenn checked false ist.

Mögliche Enum-Werte

vegan

Alle Zutaten sind vegan.

vegetarian

Alle Zutaten sind vegetarisch (nicht alle vegan).

non_vegetarian

Mindestens eine Zutat enthält Fleisch oder Fisch.

unclassified

Mindestens eine Zutat ist noch nicht eingeordnet, daher lässt sich keine Ernährungsform angeben.

animal_sources string[]
Tierarten, die irgendwo im Rezept enthalten sind: pork, beef, poultry, game, lamb, fish, seafood, other (sonstiges Fleisch). Leer, außer bei non_vegetarian.
checked boolean
false, wenn das Rezept in dieser Anfrage nicht geprüft werden konnte (durch den Plan gesperrt, zu groß oder über dem Umfangsbudget der Anfrage): diet ist dann null und animal_sources leer — keine Aussage. Frage das Rezept einzeln ab, um es zu prüfen.
created_at string
ISO-8601-Erstellungszeitpunkt.
updated_at string
ISO-8601-Zeitpunkt der letzten Änderung.
Das Rezept-Objekt
{
  "id": "01932a1c-8f4e-7b2a-9c3d-1e5f6a7b8c9d",
  "name": "Apple Cake",
  "identifier": "RC-1001",
  "categories": ["Desserts", "Cakes"],
  "folders": ["Bakery"],
  "is_linked_to_ingredient": true,
  "linked_ingredients": [
    {
      "id": "01932a1c-b4d5-7e3f-8a6b-5c8d9e0f1a2b",
      "name": "Apple Cake Mix",
      "is_dynamic": false
    }
  ],
  "food_type": "solid",
  "portions": {
    "portion_name": "Slice",
    "portion_count": 12,
    "portion_weight": "85.00",
    "portion_by_weight": false,
    "reduction_factor": 1
  },
  "ingredients": [
    {
      "id": "01932a1c-9a1b-7c2d-8e4f-2f6a7b8c9d0e",
      "name": "Wheat Flour",
      "amount": "200.00",
      "unit": "g",
      "weight": "200.00",
      "mise_en_place": null,
      "type": "custom",
      "is_linked": false,
      "is_dynamic": false
    }
  ],
  "ingredient_list": "Wheat flour, sugar, apples…",
  "instructions": [
    { "order": 0, "text": "Mix flour, sugar, and apples." },
    { "order": 1, "text": "Bake until golden." }
  ],
  "preparation": {
    "description": "A classic tray bake.",
    "serving_suggestion": "Serve warm",
    "side_dishes": null,
    "required_equipment": "Oven",
    "utensils": null,
    "preparation_time_minutes": 20,
    "waiting_time_minutes": 0,
    "cooking_time_minutes": 45,
    "comments": null
  },
  "storage": {
    "shelf_life_days": 3,
    "temperature_celsius": 18,
    "storage_instructions": "Keep cool and dry",
    "packaging": null
  },
  "product": {
    "article_number": "AC-12",
    "brand": null,
    "quality": null,
    "origin_type": null,
    "product_origin": null,
    "product_notes": null,
    "declaration_notice": null
  },
  "nutrition": {
    "total_weight": "1200.00",
    "portion_weight": "85.00",
    "per_100g": {
      "energy_kj": 1200,
      "energy_kcal": 287,
      "fat": 8.5,
      "saturated_fat": 3.2,
      "carbs": 46.0,
      "sugars": 22.0,
      "protein": 4.8,
      "salt": 0.42,
      "fiber": 1.6,
      "alcohol": 0
    },
    "per_portion": {
      "energy_kj": 102,
      "energy_kcal": 24,
      "fat": 0.7,
      "saturated_fat": 0.3,
      "carbs": 3.9,
      "sugars": 1.9,
      "protein": 0.4,
      "salt": 0.04,
      "fiber": 0.1,
      "alcohol": 0
    }
  },
  "allergens": [{ "code": 1, "name": "Gluten" }],
  "additives": [],
  "food_tags": {
    "diet": "vegetarian",
    "animal_sources": [],
    "checked": true
  },
  "created_at": "2025-06-01T10:00:00.000000Z",
  "updated_at": "2025-08-10T14:30:00.000000Z"
}

Rezept abrufen V1 #

GET /api/v1/recipes/:id

Liefert die Details eines Rezepts, auf das der Token zugreifen darf.

Erforderlicher Scope: recipes:read

Parameter

id string Erforderlich path
Die Rezept-ID.

Rückgabe

Gibt ein Rezept-Objekt zurück.

Fehlercodes
401
unauthenticated

Fehlendes, ungültiges, abgelaufenes oder widerrufenes Bearer-Token.

403
missing_scope

Das Token ist gültig, wurde aber ohne den erforderlichen Scope ausgestellt.

403
forbidden

Dem Konto fehlt die erforderliche Funktion, oder dem Benutzer fehlt die erforderliche Berechtigung.

404
not_found

Das Rezept existiert nicht oder ist mit diesem Token nicht erreichbar.

429
rate_limited

Zu viele Anfragen. Erneut versuchen nach dem Retry-After-Header.

Antwort
{
  "data": {
  "id": "01932a1c-8f4e-7b2a-9c3d-1e5f6a7b8c9d",
  "name": "Apple Cake",
  "identifier": "RC-1001",
  "categories": ["Desserts", "Cakes"],
  "folders": ["Bakery"],
  "is_linked_to_ingredient": true,
  "linked_ingredients": [
    {
      "id": "01932a1c-b4d5-7e3f-8a6b-5c8d9e0f1a2b",
      "name": "Apple Cake Mix",
      "is_dynamic": false
    }
  ],
  "food_type": "solid",
  "portions": {
    "portion_name": "Slice",
    "portion_count": 12,
    "portion_weight": "85.00",
    "portion_by_weight": false,
    "reduction_factor": 1
  },
  "ingredients": [
    {
      "id": "01932a1c-9a1b-7c2d-8e4f-2f6a7b8c9d0e",
      "name": "Wheat Flour",
      "amount": "200.00",
      "unit": "g",
      "weight": "200.00",
      "mise_en_place": null,
      "type": "custom",
      "is_linked": false,
      "is_dynamic": false
    }
  ],
  "ingredient_list": "Wheat flour, sugar, apples…",
  "instructions": [
    { "order": 0, "text": "Mix flour, sugar, and apples." },
    { "order": 1, "text": "Bake until golden." }
  ],
  "preparation": {
    "description": "A classic tray bake.",
    "serving_suggestion": "Serve warm",
    "side_dishes": null,
    "required_equipment": "Oven",
    "utensils": null,
    "preparation_time_minutes": 20,
    "waiting_time_minutes": 0,
    "cooking_time_minutes": 45,
    "comments": null
  },
  "storage": {
    "shelf_life_days": 3,
    "temperature_celsius": 18,
    "storage_instructions": "Keep cool and dry",
    "packaging": null
  },
  "product": {
    "article_number": "AC-12",
    "brand": null,
    "quality": null,
    "origin_type": null,
    "product_origin": null,
    "product_notes": null,
    "declaration_notice": null
  },
  "nutrition": {
    "total_weight": "1200.00",
    "portion_weight": "85.00",
    "per_100g": {
      "energy_kj": 1200,
      "energy_kcal": 287,
      "fat": 8.5,
      "saturated_fat": 3.2,
      "carbs": 46.0,
      "sugars": 22.0,
      "protein": 4.8,
      "salt": 0.42,
      "fiber": 1.6,
      "alcohol": 0
    },
    "per_portion": {
      "energy_kj": 102,
      "energy_kcal": 24,
      "fat": 0.7,
      "saturated_fat": 0.3,
      "carbs": 3.9,
      "sugars": 1.9,
      "protein": 0.4,
      "salt": 0.04,
      "fiber": 0.1,
      "alcohol": 0
    }
  },
  "allergens": [{ "code": 1, "name": "Gluten" }],
  "additives": [],
  "food_tags": {
    "diet": "vegetarian",
    "animal_sources": [],
    "checked": true
  },
  "created_at": "2025-06-01T10:00:00.000000Z",
  "updated_at": "2025-08-10T14:30:00.000000Z"
}}

Rezepte listen V1 #

GET /api/v1/recipes

Liefert eine paginierte Liste der Rezept-Kurzformen, auf die der Token zugreifen darf.

Erforderlicher Scope: recipes:read

Parameter

page integer query
Seitennummer (Standard 1).
per_page integer query
Einträge pro Seite (Standard 25, max. 100).
search string query
Namensfilter, nicht case-sensitiv (max. 255 Zeichen).
sort string query
Feld, nach dem die Seite sortiert wird.

Mögliche Enum-Werte

name

Nach Rezepttitel sortieren.

created_at

Nach Erstellungszeit sortieren.

updated_at

Nach letzter Änderung sortieren.

sort_direction string query
Sortierrichtung (Standard asc).

Mögliche Enum-Werte

asc

Aufsteigend (Standard).

desc

Absteigend.

Rückgabe

Antwortattribute

data object[]
Rezept-Kurzformen auf dieser Seite. Jedes Objekt ist eine Listenzeile, nicht das volle Rezept-Objekt. Nutze Rezept abrufen für Nährwerte, Zutaten und Kennzeichnungsfelder.
Unterattribute anzeigen Unterattribute ausblenden
id string
Eindeutige Kennung des Rezepts.
name string
Rezepttitel.
identifier string
Interne Rezeptnummer / SKU, falls gesetzt.
categories string[]
Kategorien des Rezepts.
folders string[]
Ordnernamen, wenn Ordner-Zugriff vorhanden ist.
is_linked_to_ingredient boolean
true, wenn mindestens eine eigene Zutat auf dieses Rezept zeigt.
linked_ingredients object[]
Verknüpfte eigene Zutaten. Leer, wenn nicht verknüpft.
Unterattribute anzeigen Unterattribute ausblenden
id string
Eindeutige Kennung der Zutat.
name string
Zutatenname in Titelschreibweise.
is_dynamic boolean
true, wenn die verknüpfte Zutat ein dynamisches, rezeptgestütztes Element ist.
food_tags object
Ernährungsform und Tierart, jedes Mal aus den Zutaten abgeleitet (Rezepte speichern sie nicht). Dieselbe Einordnung wie „Ernährungsform & Tierart“ in der Web-App.
Unterattribute anzeigen Unterattribute ausblenden
diet string
Ernährungsform des Rezepts. null nur, wenn checked false ist.

Mögliche Enum-Werte

vegan

Alle Zutaten sind vegan.

vegetarian

Alle Zutaten sind vegetarisch (nicht alle vegan).

non_vegetarian

Mindestens eine Zutat enthält Fleisch oder Fisch.

unclassified

Mindestens eine Zutat ist noch nicht eingeordnet, daher lässt sich keine Ernährungsform angeben.

animal_sources string[]
Tierarten, die irgendwo im Rezept enthalten sind: pork, beef, poultry, game, lamb, fish, seafood, other (sonstiges Fleisch). Leer, außer bei non_vegetarian.
checked boolean
false, wenn das Rezept in dieser Anfrage nicht geprüft werden konnte (durch den Plan gesperrt, zu groß oder über dem Umfangsbudget der Anfrage): diet ist dann null und animal_sources leer — keine Aussage. Frage das Rezept einzeln ab, um es zu prüfen.
created_at string
ISO-8601-Erstellungszeitpunkt.
updated_at string
ISO-8601-Zeitpunkt der letzten Änderung.
links object
URLs benachbarter Seiten. prev und next sind null, wenn es keine vorherige oder nächste Seite gibt.
Unterattribute anzeigen Unterattribute ausblenden
first string
URL der ersten Seite.
last string
URL der letzten Seite.
prev string
URL der vorherigen Seite, oder null.
next string
URL der nächsten Seite, oder null.
meta object
Paginierungszahlen und der Request-Pfad.
Unterattribute anzeigen Unterattribute ausblenden
current_page integer
Aktuelle Seitennummer (1-basiert).
from integer
Index des ersten Rezepts auf dieser Seite, oder null wenn die Seite leer ist.
last_page integer
Nummer der letzten Seite.
links object[]
Seitennummer-Links für dieses Ergebnis (url, label, page, active).
path string
Basispfad zum Aufbau der Seiten-URLs.
per_page integer
Auf diese Antwort angewendete Seitengröße.
to integer
Index des letzten Rezepts auf dieser Seite, oder null wenn die Seite leer ist.
total integer
Gesamtzahl der Rezepte, die zur Abfrage passen.
Fehlercodes
401
unauthenticated

Fehlendes, ungültiges, abgelaufenes oder widerrufenes Bearer-Token.

403
missing_scope

Das Token ist gültig, wurde aber ohne den erforderlichen Scope ausgestellt.

403
forbidden

Dem Konto fehlt die erforderliche Funktion, oder dem Benutzer fehlt die erforderliche Berechtigung.

422
validation_failed

Mindestens ein Query-Parameter ist ungültig. Siehe das errors-Objekt.

429
rate_limited

Zu viele Anfragen. Erneut versuchen nach dem Retry-After-Header.

Antwort
{
  "data": [
    {
      "id": "01932a1c-8f4e-7b2a-9c3d-1e5f6a7b8c9d",
      "name": "Apple Cake",
      "identifier": "RC-1001",
      "categories": ["Desserts", "Cakes"],
      "folders": ["Bakery"],
      "is_linked_to_ingredient": true,
      "linked_ingredients": [
        {
          "id": "01932a1c-9a1b-7c2d-8e4f-2f6a7b8c9d0e",
          "name": "Apple Cake Mix",
          "is_dynamic": false
        }
      ],
      "food_tags": {
        "diet": "vegetarian",
        "animal_sources": [],
        "checked": true
      },
      "created_at": "2025-06-01T10:00:00.000000Z",
      "updated_at": "2025-08-10T14:30:00.000000Z"
    }
  ],
  "links": {
    "first": "https://example.test/api/v1/recipes?page=1",
    "last": "https://example.test/api/v1/recipes?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "links": [
      {"url": null, "label": "« Previous", "page": null, "active": false},
      {"url": "https://example.test/api/v1/recipes?page=1", "label": "1", "page": 1, "active": true},
      {"url": null, "label": "Next »", "page": null, "active": false}
    ],
    "path": "https://example.test/api/v1/recipes",
    "per_page": 25,
    "to": 1,
    "total": 1
  }
}

Wie ist dieser Leitfaden?