Rezepte V1
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
name
string
identifier
string
categories
string[]
folders
string[]
is_linked_to_ingredient
boolean
true, wenn mindestens eine eigene Zutat auf dieses Rezept zeigt.linked_ingredients
object[]
Unterattribute anzeigen Unterattribute ausblenden
id
string
name
string
is_dynamic
boolean
true, wenn die verknüpfte Zutat ein dynamisches, rezeptgestütztes Element ist.food_type
string
g / ml.
Mögliche Enum-Werte
solid
Festes Lebensmittel (interne g-Messung).
liquid
Flüssigkeit (interne ml-Messung).
portions
object
Unterattribute anzeigen Unterattribute ausblenden
portion_name
string
portion_count
integer
portion_weight
string
portion_by_weight
boolean
true, wenn Portionen nach Gewicht definiert sind.reduction_factor
number
ingredients
object[]
Unterattribute anzeigen Unterattribute ausblenden
id
string
name
string
amount
string
unit
string
g).weight
string
mise_en_place
string
null.type
string
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
instructions
object[]
Unterattribute anzeigen Unterattribute ausblenden
order
integer
text
string
preparation
object
Unterattribute anzeigen Unterattribute ausblenden
description
string
null.serving_suggestion
string
null.side_dishes
string
null.required_equipment
string
null.utensils
string
null.preparation_time_minutes
integer
null.waiting_time_minutes
integer
null.cooking_time_minutes
integer
null.comments
string
null.storage
object
Unterattribute anzeigen Unterattribute ausblenden
shelf_life_days
integer
null.temperature_celsius
number
null.storage_instructions
string
null.packaging
string
null.product
object
Unterattribute anzeigen Unterattribute ausblenden
article_number
string
null.brand
string
null.quality
string
null.origin_type
string
null.product_origin
string
null.product_notes
string
null.declaration_notice
string
null.nutrition
object
Unterattribute anzeigen Unterattribute ausblenden
total_weight
string
portion_weight
string
per_100g
object
Unterattribute anzeigen Unterattribute ausblenden
energy_kj
number
energy_kcal
number
fat
number
saturated_fat
number
carbs
number
sugars
number
protein
number
salt
number
fiber
number
alcohol
number
per_portion
object
Unterattribute anzeigen Unterattribute ausblenden
energy_kj
number
energy_kcal
number
fat
number
saturated_fat
number
carbs
number
sugars
number
protein
number
salt
number
fiber
number
alcohol
number
allergens
object[]
Unterattribute anzeigen Unterattribute ausblenden
code
integer
name
string
additives
object[]
Unterattribute anzeigen Unterattribute ausblenden
code
integer
name
string
food_tags
object
Unterattribute anzeigen Unterattribute ausblenden
diet
string
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[]
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
updated_at
string
{
"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 #
/api/v1/recipes/:id
Liefert die Details eines Rezepts, auf das der Token zugreifen darf.
Parameter
id
string
Erforderlich
Rückgabe
Gibt ein Rezept-Objekt zurück.
unauthenticated
Fehlendes, ungültiges, abgelaufenes oder widerrufenes Bearer-Token.
missing_scope
Das Token ist gültig, wurde aber ohne den erforderlichen Scope ausgestellt.
forbidden
Dem Konto fehlt die erforderliche Funktion, oder dem Benutzer fehlt die erforderliche Berechtigung.
not_found
Das Rezept existiert nicht oder ist mit diesem Token nicht erreichbar.
rate_limited
Zu viele Anfragen. Erneut versuchen nach dem Retry-After-Header.
curl -X GET https://portal.rezeptrechner.de/api/v1/recipes/:id \
-H "Authorization: Bearer $TOKEN"
require "net/http"
require "uri"
uri = URI("https://portal.rezeptrechner.de/api/v1/recipes/:id")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{token}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request)
end
import requests
response = requests.get(
"https://portal.rezeptrechner.de/api/v1/recipes/:id", headers={"Authorization": f"Bearer {token}"},
)
$response = Http::withToken($token)
->get('https://portal.rezeptrechner.de/api/v1/recipes/:id');
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://portal.rezeptrechner.de/api/v1/recipes/:id"))
.header("Authorization", "Bearer " + token)
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
const response = await fetch("https://portal.rezeptrechner.de/api/v1/recipes/:id", {
method: "GET",
headers: { Authorization: `Bearer ${token}` },
});
{
"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 #
/api/v1/recipes
Liefert eine paginierte Liste der Rezept-Kurzformen, auf die der Token zugreifen darf.
Parameter
page
integer
1).per_page
integer
25, max. 100).search
string
sort
string
Mögliche Enum-Werte
name
Nach Rezepttitel sortieren.
created_at
Nach Erstellungszeit sortieren.
updated_at
Nach letzter Änderung sortieren.
sort_direction
string
asc).
Mögliche Enum-Werte
asc
Aufsteigend (Standard).
desc
Absteigend.
Rückgabe
Antwortattribute
data
object[]
Unterattribute anzeigen Unterattribute ausblenden
id
string
name
string
identifier
string
categories
string[]
folders
string[]
is_linked_to_ingredient
boolean
true, wenn mindestens eine eigene Zutat auf dieses Rezept zeigt.linked_ingredients
object[]
Unterattribute anzeigen Unterattribute ausblenden
id
string
name
string
is_dynamic
boolean
true, wenn die verknüpfte Zutat ein dynamisches, rezeptgestütztes Element ist.food_tags
object
Unterattribute anzeigen Unterattribute ausblenden
diet
string
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[]
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
updated_at
string
links
object
prev und next sind null, wenn es keine vorherige oder nächste Seite gibt.Unterattribute anzeigen Unterattribute ausblenden
first
string
last
string
prev
string
null.next
string
null.meta
object
Unterattribute anzeigen Unterattribute ausblenden
current_page
integer
from
integer
null wenn die Seite leer ist.last_page
integer
links
object[]
url, label, page, active).path
string
per_page
integer
to
integer
null wenn die Seite leer ist.total
integer
unauthenticated
Fehlendes, ungültiges, abgelaufenes oder widerrufenes Bearer-Token.
missing_scope
Das Token ist gültig, wurde aber ohne den erforderlichen Scope ausgestellt.
forbidden
Dem Konto fehlt die erforderliche Funktion, oder dem Benutzer fehlt die erforderliche Berechtigung.
validation_failed
Mindestens ein Query-Parameter ist ungültig. Siehe das errors-Objekt.
rate_limited
Zu viele Anfragen. Erneut versuchen nach dem Retry-After-Header.
curl -G https://portal.rezeptrechner.de/api/v1/recipes \
-H "Authorization: Bearer $TOKEN" \
-d "search=Apple"
require "net/http"
require "uri"
uri = URI("https://portal.rezeptrechner.de/api/v1/recipes")
uri.query = URI.encode_www_form({search: "Apple"})
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{token}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
http.request(request)
end
import requests
response = requests.get(
"https://portal.rezeptrechner.de/api/v1/recipes", params={
"search": "Apple",
}, headers={"Authorization": f"Bearer {token}"},
)
$response = Http::withToken($token)
->get('https://portal.rezeptrechner.de/api/v1/recipes', [
'search' => 'Apple',
]);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://portal.rezeptrechner.de/api/v1/recipes?search=Apple"))
.header("Authorization", "Bearer " + token)
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
const url = new URL("https://portal.rezeptrechner.de/api/v1/recipes");
url.searchParams.set("search", "Apple");
const response = await fetch(url, {
headers: { Authorization: `Bearer ${token}` },
});
{
"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?
Danke für dein Feedback.