Champs de réponse

Ce que l'API renvoie pour les recettes, les fournitures et les produits : valeurs de CO₂ et notations, Vita Score, indicateurs environnementaux et valeurs nutritionnelles. Les champs de chaque ressource sont listés sur les pages Recettes, Fournitures et Produits.

CO₂ et notations

Indicateurs CO₂

Les champs au niveau de la recette (co2-value, rating, eaternity-award, valeurs d'amélioration et de réduction) sont décrits sous Propriétés de la réponse.

Échelle de notation

Notation	CO₂ par portion	Description
A	≤ 400g	Excellent : impact environnemental très faible
B	401-600g	Bon : impact environnemental faible
C	601-1000g	Moyen : impact environnemental modéré
D	1001-1500g	Inférieur à la moyenne : impact environnemental élevé
E	> 1500g	Mauvais : impact environnemental très élevé

Champs de réponse de l'ingrédient

Ces champs sont renvoyés pour chaque ingrédient lorsque full-resource=true :

Champ	Type	Description
rating	string	Notation CO₂ de cet ingrédient (A-E). A est la meilleure, E la moins bonne.
co2-value	integer	Émissions de CO₂ absolues de l'ingrédient en grammes pour la quantité indiquée
co2-value-improvement-percentage	float	Comparaison de l'empreinte carbone de cet ingrédient par food unit avec la moyenne
co2-value-reduction-value	float	Grammes de CO₂ économisés par rapport à un produit moyen de même valeur nutritionnelle
bar-chart	number	Part de cet ingrédient dans le CO₂ total de la recette, en pourcentage (0-100)
foodUnit	number	Valeur de densité nutritionnelle utilisée pour les calculs de CO₂ par valeur nutritionnelle
nutrient-values-estimated-per-specified-amount	object	Valeurs nutritionnelles estimées par le backend pour la quantité indiquée (lorsque nutrient-values=true est défini)
indicators	object	Indicateurs environnementaux de cet ingrédient (lorsque indicators=true est défini)

foodUnit expliqué

Le foodUnit représente la valeur nutritionnelle d'un aliment. Il sert à calculer les émissions de CO₂ par unité nutritionnelle plutôt que par gramme. Cela garantit une comparaison équitable entre des aliments de densités caloriques différentes.

---

Vita Score

Le Vita Score évalue la qualité nutritionnelle sur une échelle de A à E, à partir de facteurs de risque pour la santé.

Champs principaux

Champ	Type	Description
vita-score-points	number	Total des points (moins il y en a, plus c'est sain)
vita-score-rating	string	Notation de A (le plus sain) à E
vita-score-award	boolean	true si la recette obtient la notation A ou B
energy-kcals	number	Total des calories
nutrition-label	boolean	true si la recette est équilibrée sur le plan nutritionnel

Champs des facteurs de risque

Chaque facteur de risque a deux champs : {factor}-risk-factor-amount-gram (quantité) et {factor}-risk-factor-points (points d'impact sur la santé).

Facteur de risque	Sens favorable à la santé	Description
fruit	Plus, c'est mieux	Teneur en fruits
vegetable	Plus, c'est mieux	Teneur en légumes
wholegrain	Plus, c'est mieux	Teneur en céréales complètes
nuts-seeds	Plus, c'est mieux	Noix et graines
milk	Avec modération	Produits laitiers
processed-meat	Moins, c'est mieux	Produits carnés transformés
red-meat	Moins, c'est mieux	Teneur en viande rouge
salt	Moins, c'est mieux	Teneur en sodium

Points de risque des macronutriments

Champ	Description
high-in-energy-risk-factor-points	Points pour une densité calorique élevée
high-in-fat-risk-factor-points	Points pour une teneur élevée en matières grasses
low-in-fat-risk-factor-points	Points pour une teneur insuffisante en matières grasses
high-in-protein-risk-factor-points	Points pour un excès de protéines
low-in-protein-risk-factor-points	Points pour une teneur insuffisante en protéines

---

Indicateurs environnementaux

Indicateurs d'impact environnemental supplémentaires, au-delà du CO₂. À activer avec indicators=true.

Tous les calculs utilisent la méthodologie d'analyse du cycle de vie (LCA) selon les normes ISO 14040/14044, avec des données scientifiques évaluées par des pairs couvrant toute la chaîne d'approvisionnement, de la ferme à l'assiette.

Interprétation du CO₂

Les valeurs de CO₂ mesurent les émissions totales de gaz à effet de serre en grammes d'équivalent CO₂, y compris le CO₂, le méthane (CH₄, 28 fois plus puissant) et le protoxyde d'azote (N₂O, 265 fois plus puissant). Les seuils de notation par portion figurent dans l'Échelle de notation.

Principales sources d'émissions : agriculture (40-70 %), production animale (20-50 %), transport (5-15 %), transformation (5-10 %), stockage (2-5 %).

Empreinte hydrique

Champ	Type	Description
scarce-water-liters	number	Litres d'eau rare utilisés
water-footprint-rating	string	Notation A-E de la consommation d'eau
water-footprint-award	boolean	true pour une excellente efficacité hydrique
water-footprint-improvement-percentage	number	% de mieux que la moyenne
water-footprint-reduction-value	number	Litres économisés par rapport à la moyenne

Eau par portion	Catégorie
< 100L	Très faible
100-500L	Faible
500-1000L	Modérée
1000-2000L	Élevée
> 2000L	Très élevée

Traitement des animaux

Évaluation des normes de bien-être animal pour les ingrédients d'origine animale.

Notation	Description	Normes
excellent	Normes de bien-être les plus élevées	Plein air, biologique, certifié bien-être animal
good	Bien-être supérieur à la moyenne	Hors cage, logement enrichi
medium	Pratiques standard	Élevage conventionnel
poor	Bien-être inférieur à la norme	Élevage intensif/industriel
very-poor	Problèmes de bien-être	Conditions exiguës, pas d'accès à l'extérieur
not-applicable	Pas de produits d'origine animale	Articles végétaliens/végétariens

Impact sur la forêt tropicale

Risque de déforestation lié aux ingrédients.

Notation	Niveau de risque	Ingrédients courants
very-low	Risque négligeable	Légumes locaux, céréales
low	Risque minimal	Huile de palme et cacao certifiés durables
medium	Risque modéré	Certains fruits tropicaux, noix
high	Risque important	Huile de palme non certifiée, bœuf du Brésil
very-high	Risque grave	Soja issu de zones déboisées

Impact sur la biodiversité

Effet sur les écosystèmes et la diversité des espèces.

Notation	Impact	Facteurs contributifs
very-low	Impact minimal	Biologique, cultures diversifiées, favorable aux habitats
low	Impact faible	Pratiques durables, rotation des cultures
medium	Impact modéré	Monoculture conventionnelle
high	Impact important	Usage intensif de pesticides, destruction des habitats
very-high	Impact grave	Monoculture à grande échelle, déforestation

Consommation d'énergie

Consommation totale d'énergie sur l'ensemble de la chaîne d'approvisionnement, mesurée en mégajoules (MJ) par portion.

Énergie par portion	Catégorie
< 1 MJ	Très faible
1-3 MJ	Faible
3-6 MJ	Modérée
6-10 MJ	Élevée
> 10 MJ	Très élevée

Impact sur les sols

Effet sur la santé et la dégradation des sols.

Notation	Impact	Pratiques
very-low	Formation de sol	Agriculture régénératrice, sans labour
low	Dégradation minimale	Biologique, cultures de couverture
medium	Dégradation partielle	Agriculture conventionnelle, rotation
high	Dégradation importante	Monoculture intensive, labour profond
very-high	Dégradation grave	Pratiques favorisant l'érosion

Labels de durabilité

Chaque indicateur a un {name}-label (booléen) et un {name}-rating (A-E) :

Indicateur	Signification du label	Ce qu'il mesure
rainforest	Sans déforestation	Évite la destruction de la forêt tropicale
animal-treatment	Bien-être certifié	Respecte les normes de bien-être animal
season	De saison	L'ingrédient est de saison localement
local	Produit localement	Produit dans la région

---

Valeurs nutritionnelles

Les mêmes champs nutritionnels sont utilisés dans les requests (nutrient-values) et dans les réponses (nutrient-values-estimated-per-specified-amount, nutrient-values-estimated-per-recipe-portion). Dans les requests, tous sont facultatifs : fournissez ceux dont vous disposez.

Macronutriments de base

Champ	Unité	Description
energy-kcal	kcal	Énergie en kilocalories
energy-kjoule	kJ	Énergie en kilojoules
fat-gram	g	Matières grasses totales
saturated-fat-gram	g	Acides gras saturés
monounsaturated-fat-milligram	mg	Acides gras monoinsaturés
polyunsaturated-fat-milligram	mg	Acides gras polyinsaturés
cholesterol-milligram	mg	Cholestérol
carbohydrates-gram	g	Glucides totaux
sucrose-gram	g	Sucres
protein-gram	g	Protéines
fibers-gram	g	Fibres alimentaires
water-gram	g	Teneur en eau
sodium-chloride-gram	g	Sel
alcohol-volume-percent	%	Teneur en alcool

Vitamines

Champ	Unité	Vitamine
vitamine-a1-microgram	mcg	Vitamine A (rétinol)
vitamine-b1-microgram	mcg	Vitamine B1 (thiamine)
vitamine-b2-microgram	mcg	Vitamine B2 (riboflavine)
vitamine-b6-microgram	mcg	Vitamine B6 (pyridoxine)
vitamine-b12-microgram	mcg	Vitamine B12 (cobalamine)
vitamine-c-milligram	mg	Vitamine C
vitamine-d-microgram	mcg	Vitamine D
vitamine-e-microgram	mcg	Vitamine E (tocophérol)
vitamine-h-microgram	mcg	Vitamine H (biotine)
vitamine-k-microgram	mcg	Vitamine K
beta-carotene-milligram	mg	Bêta-carotène
niacin-milligram	mg	Niacine (B3)
pantohen-milligram	mg	Acide pantothénique (B5)
folic-acid-microgram	mcg	Acide folique (B9)

Minéraux

Champ	Unité	Minéral
sodium-milligram	mg	Sodium
potassium-milligram	mg	Potassium
chlorine-milligram	mg	Chlore
calcium-milligram	mg	Calcium
magnesium-milligram	mg	Magnésium
phosphorus-milligram	mg	Phosphore
iron-milligram	mg	Fer
zinc-microgram	mcg	Zinc
copper-microgram	mcg	Cuivre
manganese-microgram	mcg	Manganèse
flouride-microgram	mcg	Fluorure
iodine-microgram	mcg	Iode

Autres composés

Champ	Unité	Description
purine-milligram	mg	Teneur en purines
uric-acid-milligram	mg	Acide urique

---

Les sources de données derrière ces valeurs sont décrites dans Méthodologie › Sources de données.