Zutaten

Rezepte, Einkäufe und Produkte sind Listen von Zutaten. Alle drei verwenden dasselbe Zutatenobjekt, das auf dieser Seite beschrieben ist.

• Ein Rezept führt seine Zutaten unter ingredients auf. Siehe Rezepte.
• Ein Einkauf führt die gelieferten Artikel unter ingredients auf. Siehe Einkäufe.
• Ein Produkt ist eine Zutat, die Sie einmal speichern und in vielen Rezepten referenzieren. Siehe Produkte.

Thema	Abschnitt
Beispiel	Zutatenschema
Felder, die Sie senden müssen	Erforderliche Eigenschaften
Felder, die das Ergebnis verbessern	Optionale Kerneigenschaften
Erlaubte Werte: origin, transport, production, processing, conservation, packaging, unit	Werte der Zutatenfelder
Eine Zutat definieren oder referenzieren	Zutatentypen
Was pro Zutat zurückkommt	Response-Felder der Zutat
Wie Namen zugeordnet werden	Zutaten-Matching

Zutatenschema

{
  "id": "tomatoes-001",
  "names": [
    {"language": "en", "value": "Cherry Tomatoes"},
    {"language": "de", "value": "Kirschtomaten"}
  ],
  "amount": 200,
  "unit": "gram",
  "origin": "Italy",
  "transport": "ground",
  "production": "organic",
  "conservation": "fresh",
  "packaging": "plastic",
  "producer": "BioFarm AG"
}

Erforderliche Eigenschaften

Eigenschaft	Typ	Erforderlich	Beschreibung
id	String	Ja	Eindeutige Zutaten-ID innerhalb des Rezepts (max. 255 Zeichen)
names	Array	Ja	Name der Zutat in mindestens einer Sprache, als Array von Sprachobjekten: [{"language": "en", "value": "..."}]. Wird für das Matching mit der Datenbank verwendet.
amount	Float	Ja	Menge der Zutat (muss > 0 sein)
unit	String	Ja	Masseinheit (gram oder liter)

Optionale Kerneigenschaften

Mehrdeutigkeit reduzieren

Um Mehrdeutigkeit zu reduzieren und manuelle Rückfragen zu minimieren, empfehlen wir dringend, bestimmte Zutatenattribute anzugeben, auch wenn sie technisch optional sind. Dazu gehören Angaben wie per Luftfracht, frisch, tiefgekühlt, getrocknet, konserviert, gebacken, in Dosen, gekocht, biologisch, Fairtrade-zertifiziert und aus Aquakultur (bei Fisch). Wenn Sie diese Daten von Anfang an mitliefern, vermeiden Sie falsche Annahmen und wiederholte Rückfragen.

Eigenschaft	Typ	Standard	Beschreibung
type	String	conceptual-ingredients	Ob diese Zeile eine Zutat definiert oder eine bereits gespeicherte referenziert. Siehe Zutatentypen.
loss-in-percent-of-amount	Float	-	Lebensmittelverlust in Prozent der Zutatenmenge (0–100), zum Beispiel durch Schälen, Rüsten oder Verderb. Die Umweltwirkung wird für die gesamte angegebene Menge berechnet, während nur die verbleibende Nettomenge (amount × (1 − loss / 100)) zum Gewicht und zu den Nährwerten des Rezepts zählt. Für die Abbildung von Verlusten besser geeignet als eine Anpassung des Rezeptfelds weight.
origin	String	-	Herkunft der Zutat: Postadresse oder Land
transport	String	-	Transportmittel von der Herkunft zur Küche: air oder ground
production	String	-	Produktionsmethode: standard, greenhouse, organic, fair-trade, farm, wild-caught, sustainable-fish
processing	String	-	Verarbeitungsgrad: raw. Fleisch/Fisch: unboned, boned. Fisch: skinned, beheaded, fillet. Gemüse/Früchte: cut, boiled, peeled.
conservation	String	-	Konservierungsmethode: fresh, frozen, dried, conserved, canned, boiled-down
packaging	String	-	Verpackungsart: none, plastic, paper, pet, tin, alu, glas, cardboard, tetra
producer	String	-	Hersteller oder Marke des Produkts. Besonders wichtig bei zusammengesetzten Produkten (Produkte mit mehreren Zutaten).
gtin	String	-	Global Trade Item Number (Strichcode) für verpackte Produkte
ingredients-declaration	String	-	Zutatenliste, wie sie auf verpackten Lebensmitteln deklariert ist
nutrient-values	Object	-	Strukturierte Nährwerte pro 100 g (siehe Referenz)

Erlaubte Werte, Standardwerte und mehrere Werte pro Feld: Werte der Zutatenfelder.

Werte der Zutatenfelder

Die folgenden Attribute beschreiben, woher eine Zutat stammt und wie sie produziert, verarbeitet, konserviert und verpackt wird. Sie sind optional, aber jedes macht das Ergebnis genauer.

origin

Wo die Zutat produziert wurde. Davon hängen die Berechnungen von Transportdistanz und Saisonalität ab.

Format	Beispiel	Beschreibung
Land	"Italy"	Produktionsland
Postadresse	"8005 Zurich, Switzerland"	Genauer Ort für präzise Transportdistanzen

Standard: Ohne Angabe wird eine repräsentative Herkunft aus der Zutat und dem Standort der Küche geschätzt.

transport

Wie die Zutat von der Herkunft zur Küche transportiert wird.

Wert	Beschreibung	CO₂-Wirkung
ground	Transport auf Strasse, Schiene oder per Schiff	Tiefer
air	Luftfracht	Höher (10- bis 50-mal ground)

Standard: keiner. Ohne Angabe wird das Transportmittel aus Herkunft und Ziel geschätzt.

production

Die Methode, mit der die Zutat angebaut oder produziert wird.

Wert	Beschreibung
standard	Konventionelle Landwirtschaft/Produktion
greenhouse	Im beheizten Gewächshaus angebaut
organic	Zertifizierte biologische Produktion
fair-trade	Fairtrade-zertifiziert
farm	Kleinbäuerliche Produktion
wild-caught	Wildfang (Meeresfrüchte)
sustainable-fish	Nachhaltig zertifizierte Fischerei

processing

Der Verarbeitungsgrad der Zutat.

Wert	Beschreibung
raw	Unverarbeitete, ganze Zutat
unboned	Mit Knochen (Fleisch/Fisch)
boned	Ohne Knochen
skinned	Ohne Haut
beheaded	Ohne Kopf (Fisch)
fillet	Filetiert (Fleisch/Fisch)
cut	In Stücke geschnitten
boiled	Durch Kochen vorgegart
peeled	Äussere Schicht entfernt

conservation

Wie die Zutat haltbar gemacht bzw. gelagert wird.

Wert	Beschreibung	Energiewirkung
fresh	Nicht haltbar gemacht, kurze Haltbarkeit	Am tiefsten
frozen	Tiefgekühlte Lagerung	Höher (Kühlkette)
dried	Getrocknet	Tief
conserved	Konserviert (Salz, Zucker usw.)	Tief
canned	In Dosen verschlossen	Mittel
boiled-down	Eingekocht/konzentriert	Mittel

packaging

Das verwendete Verpackungsmaterial.

Wert	Beschreibung
none	Keine Verpackung (lose)
plastic	Kunststoffverpackung
paper	Papier/Karton
pet	PET-Flaschen
tin	Konservendosen
alu	Aluminium
glas	Glasbehälter
cardboard	Kartonschachteln
tetra	Tetra-Pak-Packungen

unit

Die Masseinheit der Zutatenmenge.

Wert	Beschreibung
gram	Gewicht in Gramm
liter	Volumen in Litern

Umrechnung von Einheiten

Rechnen Sie immer in Gramm oder Liter um:

• 1 kg = 1000 Gramm
• 1 ml = 0.001 Liter
• 1 oz ≈ 28.35 Gramm
• 1 cup ≈ 240 ml = 0.24 Liter

Felder mit mehreren Werten

Die Felder origin, transport, production, processing, conservation und packaging akzeptieren kommagetrennte Werte, wenn mehrere zutreffen. Zum Beispiel: "production": "organic, fair-trade".

Zutatentypen

Jede Zutat hat einen type. Er bestimmt, worauf sich die Zutat bezieht – und ob das Speichern des Rezepts auch das Objekt schreibt, das diese ID bezeichnet.

type	Bezieht sich auf	Schreibt das Speichern des Rezepts dieses Objekt?	Wenn die ID nicht existiert
conceptual-ingredients (Standard)	eine inline definierte Zutat	Ja — wird erstellt oder für jedes Rezept überschrieben, das diese ID bereits verwendet	Sie wird erstellt
recipes	ein gespeichertes Rezept (ein Unterrezept)	Nein	612
products	ein gespeichertes Produkt	Nein	612 (auch bei einer ID, die nur eine Zutat ist)

// DEFINE an ingredient, here and now (default)
{
  "id": "rice-001",
  "type": "conceptual-ingredients",
  "names": [{"language": "en", "value": "Risotto rice"}],
  "amount": 200,
  "unit": "gram"
}

// REFERENCE a stored recipe (sub-recipe)
{
  "id": "tomato-sauce-001",
  "type": "recipes",
  "amount": 150,
  "unit": "gram"
}

// REFERENCE a stored product -- no name needed, just the id and how much goes in
{
  "id": "carrot-puree-500g",
  "type": "products",
  "amount": 300,
  "unit": "gram"
}

Nur conceptual-ingredients schreibt: Verwenden Sie damit eine ID wieder, ersetzen Ihre Daten alles, was vorher da war, für jedes Rezept mit dieser ID. Einen Artikel, den Sie wiederverwenden, speichern Sie besser einmal als Produkt und referenzieren ihn.

Response-Felder der Zutat

Siehe Response-Felder der Zutat.

Zutaten-Matching

Die API verwendet unscharfes Matching (Fuzzy Matching), um Zutaten in der Eaternity-Datenbank mit über 50'000 Einträgen zu erkennen.

So funktioniert das Matching:

1. Normalisierung des Namens: Entfernt Sonderzeichen, vereinheitlicht die Schreibweise
2. Datenbanksuche: Durchsucht über 50'000 Zutateneinträge
3. Ähnlichkeitsbewertung: Berechnet die Sicherheit der Zuordnung (0–100 %)
4. Auswahl des besten Treffers: Gibt den Treffer mit der höchsten Sicherheit zurück
5. Rückfallebene: Verwendet eine allgemeine Kategorie, wenn kein naher Treffer gefunden wird

Matching-Qualität verbessern:

• Verwenden Sie spezifische Namen: "Parmesan Cheese" statt "Cheese"
• Geben Sie die Zubereitung an: "Fresh Cherry Tomatoes" statt "Tomatoes"
• Nennen Sie Schnitt oder Form: "Beef Sirloin Steak" statt "Beef"
• Geben Sie bei verpackten Artikeln die Marke im Feld producer an