Ingrédients
Les recettes, les fournitures et les produits sont des listes d'ingrédients. Tous les trois utilisent le même objet ingrédient, décrit sur cette page.
- Une recette liste ses ingrédients sous
ingredients. Voir Recettes. - Une fourniture liste les articles livrés sous
ingredients. Voir Fournitures. - Un produit est un ingrédient que vous enregistrez une fois et que vous référencez depuis de nombreuses recettes. Voir Produits.
| Sujet | Section |
|---|---|
| Exemple | Schéma de l'ingrédient |
| Champs à envoyer obligatoirement | Propriétés obligatoires |
| Champs qui améliorent le résultat | Propriétés principales facultatives |
| Valeurs autorisées : origine, transport, production, transformation, conservation, emballage, unité | Valeurs des champs d'ingrédient |
| Définir ou référencer un ingrédient | Types d'ingrédient |
| Ce qui est renvoyé pour chaque ingrédient | Champs de réponse de l'ingrédient |
| Comment les noms sont mis en correspondance | Correspondance des ingrédients |
Schéma de l'ingrédient
{
"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"
}
Propriétés obligatoires
Propriétés principales facultatives
Pour réduire l'ambiguïté et limiter les questions de suivi manuelles, nous recommandons vivement d'indiquer certains attributs d'ingrédient, même s'ils sont techniquement facultatifs. Il s'agit notamment des indications transporté par avion, frais, surgelé, séché, conservé, cuit au four, en conserve, bouilli, biologique, certifié Fairtrade et issu de l'aquaculture (pour le poisson). Fournir ces données dès le départ évite des hypothèses erronées et supprime les allers-retours de clarification.
| Propriété | Type | Valeur par défaut | Description |
|---|---|---|---|
type | String | conceptual-ingredients | Indique si cette ligne définit un ingrédient ou référence un ingrédient déjà enregistré. Voir Types d'ingrédient. |
loss-in-percent-of-amount | Float | - | Perte alimentaire en pourcentage de la quantité de l'ingrédient (0–100), par exemple par épluchage, parage ou altération. L'impact environnemental est calculé pour la quantité indiquée complète, tandis que seule la quantité nette restante (amount × (1 − loss / 100)) compte pour le poids et les valeurs nutritionnelles de la recette. À préférer à un ajustement du champ weight de la recette pour modéliser les pertes. |
origin | String | - | Origine de l'ingrédient : adresse postale ou pays |
transport | String | - | Moyen de transport de l'origine à la cuisine : air ou ground |
production | String | - | Mode de production : standard, greenhouse, organic, fair-trade, farm, wild-caught, sustainable-fish |
processing | String | - | Niveau de transformation : raw. Viande/poisson : unboned, boned. Poisson : skinned, beheaded, fillet. Légumes/fruits : cut, boiled, peeled. |
conservation | String | - | Mode de conservation : fresh, frozen, dried, conserved, canned, boiled-down |
packaging | String | - | Type d'emballage : none, plastic, paper, pet, tin, alu, glas, cardboard, tetra |
producer | String | - | Producteur ou marque du produit. Particulièrement important pour les produits composés (produits à plusieurs ingrédients). |
gtin | String | - | Global Trade Item Number (code-barres) pour les produits emballés |
ingredients-declaration | String | - | Liste des ingrédients telle que déclarée sur les denrées emballées |
nutrient-values | Object | - | Valeurs nutritionnelles structurées pour 100 g (voir Référence) |
Valeurs autorisées, valeurs par défaut et valeurs multiples par champ : Valeurs des champs d'ingrédient.
Valeurs des champs d'ingrédient
Les attributs ci-dessous décrivent d'où vient un ingrédient et comment il est produit, transformé, conservé et emballé. Ils sont facultatifs, mais chacun rend le résultat plus précis.
origin
Lieu de production de l'ingrédient. Il détermine les calculs de distance de transport et de saisonnalité.
| Format | Exemple | Description |
|---|---|---|
| Pays | "Italy" | Pays de production |
| Adresse postale | "8005 Zurich, Switzerland" | Lieu précis pour des distances de transport exactes |
Valeur par défaut : si le champ est omis, une origine représentative est estimée à partir de l'ingrédient et de la localisation de la cuisine.
transport
Mode de transport de l'ingrédient de son origine jusqu'à la cuisine.
| Valeur | Description | Impact CO₂ |
|---|---|---|
ground | Transport routier, ferroviaire ou maritime | Plus faible |
air | Fret aérien | Plus élevé (10 à 50 fois le transport terrestre) |
Valeur par défaut : aucune. Si le champ est omis, le mode de transport est estimé à partir de l'origine et de la destination.
production
Mode de production utilisé pour cultiver ou produire l'ingrédient.
| Valeur | Description |
|---|---|
standard | Agriculture/production conventionnelle |
greenhouse | Cultivé en serre chauffée |
organic | Production biologique certifiée |
fair-trade | Certifié commerce équitable |
farm | Production en petite exploitation agricole |
wild-caught | Pêche sauvage (produits de la mer) |
sustainable-fish | Pêche certifiée durable |
processing
Niveau de transformation appliqué à l'ingrédient.
| Valeur | Description |
|---|---|
raw | Non transformé, ingrédient entier |
unboned | Avec os/arêtes (viande/poisson) |
boned | Os/arêtes retirés |
skinned | Peau retirée |
beheaded | Tête retirée (poisson) |
fillet | En filets (viande/poisson) |
cut | Coupé en morceaux |
boiled | Précuit par ébullition |
peeled | Couche extérieure retirée |
conservation
Mode de conservation/stockage de l'ingrédient.
| Valeur | Description | Impact énergétique |
|---|---|---|
fresh | Sans conservation, durée de conservation courte | Le plus faible |
frozen | Stockage surgelé | Plus élevé (chaîne du froid) |
dried | Déshydraté | Faible |
conserved | Conservé (sel, sucre, etc.) | Faible |
canned | En boîte de conserve | Moyen |
boiled-down | Réduit/concentré | Moyen |
packaging
Matériau d'emballage utilisé.
| Valeur | Description |
|---|---|
none | Sans emballage (vrac) |
plastic | Emballage plastique |
paper | Papier/carton |
pet | Bouteilles en plastique PET |
tin | Boîtes de conserve en fer-blanc |
alu | Aluminium |
glas | Contenants en verre |
cardboard | Cartons |
tetra | Briques Tetra Pak |
unit
Unité de mesure de la quantité de l'ingrédient.
| Valeur | Description |
|---|---|
gram | Poids en grammes |
liter | Volume en litres |
Convertissez toujours en grammes ou en litres :
- 1 kg = 1000 grammes
- 1 ml = 0,001 litre
- 1 oz ≈ 28,35 grammes
- 1 tasse (cup) ≈ 240 ml = 0,24 litre
Les champs origin, transport, production, processing, conservation et packaging acceptent des valeurs séparées par des virgules lorsque plusieurs s'appliquent. Par exemple : "production": "organic, fair-trade".
Types d'ingrédient
Chaque ingrédient a un type. Il détermine à quoi l'ingrédient fait référence, et si l'enregistrement de la recette écrit aussi l'objet désigné par cet id.
type | Fait référence à | L'enregistrement de la recette écrit cet objet ? | Si l'id n'existe pas |
|---|---|---|---|
conceptual-ingredients (par défaut) | un ingrédient défini en ligne | Oui : créé, ou écrasé pour toutes les recettes qui utilisent déjà cet id | Il est créé |
recipes | une recette enregistrée (une sous-recette) | Non | 612 |
products | un produit enregistré | Non | 612 (y compris un id qui n'est qu'un ingrédient) |
// 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"
}
Seul conceptual-ingredients écrit : si vous réutilisez un id avec ce type, vos données remplacent ce qui existait, pour toutes les recettes qui utilisent cet id. Pour un article que vous réutilisez, enregistrez-le une fois comme produit et référencez-le.
Champs de réponse de l'ingrédient
Voir Champs de réponse de l'ingrédient.
Correspondance des ingrédients
L'API utilise une correspondance approximative (fuzzy matching) pour identifier les ingrédients dans la base de données Eaternity de plus de 50 000 entrées.
Fonctionnement de la correspondance :
- Normalisation du nom : supprime les caractères spéciaux, normalise l'orthographe
- Recherche dans la base de données : parcourt plus de 50 000 entrées d'ingrédients
- Score de similarité : calcule la confiance de la correspondance (0-100 %)
- Choix de la meilleure correspondance : renvoie la correspondance la plus fiable
- Solution de repli : utilise une catégorie générique si aucune correspondance proche n'est trouvée
Améliorer la qualité de la correspondance :
- Utilisez des noms précis : « Parmesan » plutôt que « Fromage »
- Indiquez le mode de préparation : « Tomates cerises fraîches » plutôt que « Tomates »
- Précisez la découpe ou la forme : « Steak d'aloyau de bœuf » plutôt que « Bœuf »
- Ajoutez la marque via le champ
producerpour les articles emballés