Campi della response

Cosa restituisce l'API per ricette, forniture e prodotti: valori di CO₂ e rating, il Vita Score, gli indicatori ambientali e i valori nutrizionali. I campi per ogni risorsa sono elencati in Ricette, Forniture e Prodotti.

CO₂ e rating

Metriche CO₂

I campi a livello di ricetta (co2-value, rating, eaternity-award, valori di miglioramento e di riduzione) sono descritti in Proprietà della response.

Scala di rating

Rating	CO₂ per porzione	Descrizione
A	≤ 400g	Eccellente - Impatto ambientale molto basso
B	401-600g	Buono - Impatto ambientale basso
C	601-1000g	Medio - Impatto ambientale moderato
D	1001-1500g	Sotto la media - Impatto ambientale alto
E	> 1500g	Scarso - Impatto ambientale molto alto

Campi della response per ingrediente

Questi campi vengono restituiti per ogni ingrediente con full-resource=true:

Campo	Tipo	Descrizione
rating	string	Rating CO₂ di questo ingrediente (A-E). A è il migliore, E il peggiore.
co2-value	integer	Emissioni assolute di CO₂ dell'ingrediente in grammi per la quantità indicata
co2-value-improvement-percentage	float	Confronto dell'impronta di carbonio di questo ingrediente per food unit con la media
co2-value-reduction-value	float	Grammi di CO₂ risparmiati rispetto a un prodotto medio con lo stesso valore nutrizionale
bar-chart	number	Contributo percentuale di questo ingrediente alla CO₂ totale della ricetta (0-100)
foodUnit	number	Valore di densità nutrizionale usato per i calcoli di CO₂ per valore nutrizionale
nutrient-values-estimated-per-specified-amount	object	Valori nutrizionali stimati dal backend per la quantità indicata (con nutrient-values=true)
indicators	object	Indicatori ambientali di questo ingrediente (con indicators=true)

foodUnit spiegato

Il foodUnit rappresenta il valore nutrizionale di un alimento e serve a calcolare le emissioni di CO₂ per unità di nutrimento invece che per grammo. Così il confronto tra alimenti con densità caloriche diverse è equo.

---

Vita Score

Il Vita Score valuta la qualità nutrizionale su una scala A-E in base ai fattori di rischio per la salute.

Campi principali

Campo	Tipo	Descrizione
vita-score-points	number	Punti totali (meno punti = più sano)
vita-score-rating	string	Rating da A (più sano) a E
vita-score-award	boolean	true se la ricetta ottiene un rating A o B
energy-kcals	number	Calorie totali
nutrition-label	boolean	true se nutrizionalmente equilibrata

Campi dei fattori di rischio

Ogni fattore di rischio ha due campi: {factor}-risk-factor-amount-gram (quantità) e {factor}-risk-factor-points (punti di impatto sulla salute).

Fattore di rischio	Direzione salutare	Descrizione
fruit	Più è meglio	Contenuto di frutta
vegetable	Più è meglio	Contenuto di verdura
wholegrain	Più è meglio	Contenuto di cereali integrali
nuts-seeds	Più è meglio	Frutta a guscio e semi
milk	Moderato	Latticini
processed-meat	Meno è meglio	Prodotti a base di carne lavorata
red-meat	Meno è meglio	Contenuto di carne rossa
salt	Meno è meglio	Contenuto di sodio

Punti di rischio dei macronutrienti

Campo	Descrizione
high-in-energy-risk-factor-points	Punti per alta densità calorica
high-in-fat-risk-factor-points	Punti per alto contenuto di grassi
low-in-fat-risk-factor-points	Punti per grassi insufficienti
high-in-protein-risk-factor-points	Punti per eccesso di proteine
low-in-protein-risk-factor-points	Punti per proteine insufficienti

---

Indicatori ambientali

Metriche di impatto ambientale aggiuntive oltre alla CO₂. Si attivano con indicators=true.

Tutti i calcoli usano la metodologia Life Cycle Assessment (LCA) secondo le norme ISO 14040/14044, con dati scientifici sottoposti a revisione paritaria che coprono l'intera catena di fornitura, dal campo al piatto.

Interpretazione della CO₂

I valori di CO₂ misurano le emissioni totali di gas serra in grammi di CO₂ equivalente, inclusi CO₂, metano (CH₄, 28 volte più potente) e protossido di azoto (N₂O, 265 volte più potente). Le fasce di rating per porzione sono nella Scala di rating.

Principali fonti di emissione: agricoltura (40-70%), produzione animale (20-50%), trasporto (5-15%), lavorazione (5-10%), stoccaggio (2-5%).

Impronta idrica

Campo	Tipo	Descrizione
scarce-water-liters	number	Litri di acqua scarsa utilizzati
water-footprint-rating	string	Rating A-E per il consumo d'acqua
water-footprint-award	boolean	true per un'efficienza idrica eccellente
water-footprint-improvement-percentage	number	% migliore della media
water-footprint-reduction-value	number	Litri risparmiati rispetto alla media

Acqua per porzione	Categoria
< 100L	Molto bassa
100-500L	Bassa
500-1000L	Moderata
1000-2000L	Alta
> 2000L	Molto alta

Trattamento degli animali

Valutazione degli standard di benessere animale per gli ingredienti di origine animale.

Rating	Descrizione	Standard
excellent	Standard di benessere più elevati	Allevamento all'aperto, biologico, certificato humane
good	Benessere sopra la media	Senza gabbie, stabulazione arricchita
medium	Pratiche standard	Allevamento convenzionale
poor	Benessere sotto lo standard	Allevamento intensivo/industriale
very-poor	Problemi di benessere	Spazi ristretti, nessun accesso all'aperto
not-applicable	Nessun prodotto animale	Articoli vegani/vegetariani

Impatto sulla foresta pluviale

Rischio di deforestazione associato agli ingredienti.

Rating	Livello di rischio	Ingredienti tipici
very-low	Rischio trascurabile	Verdure locali, cereali
low	Rischio minimo	Olio di palma e cacao certificati sostenibili
medium	Rischio moderato	Alcuni frutti tropicali, frutta a guscio
high	Rischio significativo	Olio di palma non certificato, manzo dal Brasile
very-high	Rischio grave	Soia da aree disboscate

Impatto sulla biodiversità

Effetto sugli ecosistemi e sulla diversità delle specie.

Rating	Impatto	Fattori
very-low	Impatto minimo	Biologico, colture diversificate, rispettoso degli habitat
low	Impatto basso	Pratiche sostenibili, rotazione delle colture
medium	Impatto moderato	Monocoltura convenzionale
high	Impatto significativo	Uso intensivo di pesticidi, distruzione degli habitat
very-high	Impatto grave	Monocoltura su larga scala, deforestazione

Consumo di energia

Consumo totale di energia lungo la catena di fornitura, misurato in megajoule (MJ) per porzione.

Energia per porzione	Categoria
< 1 MJ	Molto basso
1-3 MJ	Basso
3-6 MJ	Moderato
6-10 MJ	Alto
> 10 MJ	Molto alto

Impatto sul suolo

Effetto sulla salute e sul degrado del suolo.

Rating	Impatto	Pratiche
very-low	Formazione di suolo	Agricoltura rigenerativa, semina su sodo
low	Degrado minimo	Biologico, colture di copertura
medium	Qualche degrado	Agricoltura convenzionale, rotazione
high	Degrado significativo	Monocoltura intensiva, lavorazione profonda
very-high	Degrado grave	Pratiche a rischio di erosione

Etichette di sostenibilità

Ogni indicatore ha un {name}-label (boolean) e un {name}-rating (A-E):

Indicatore	Significato dell'etichetta	Cosa misura
rainforest	Senza deforestazione	Evita la distruzione della foresta pluviale
animal-treatment	Benessere certificato	Rispetta gli standard di benessere animale
season	Di stagione	L'ingrediente è di stagione localmente
local	Produzione locale	Prodotto nella regione

---

Valori nutrizionali

Gli stessi campi nutrizionali si usano nelle request (nutrient-values) e nelle response (nutrient-values-estimated-per-specified-amount, nutrient-values-estimated-per-recipe-portion). Nelle request sono tutti facoltativi: fornite quelli che avete.

Macronutrienti di base

Campo	Unità	Descrizione
energy-kcal	kcal	Energia in chilocalorie
energy-kjoule	kJ	Energia in kilojoule
fat-gram	g	Grassi totali
saturated-fat-gram	g	Grassi saturi
monounsaturated-fat-milligram	mg	Grassi monoinsaturi
polyunsaturated-fat-milligram	mg	Grassi polinsaturi
cholesterol-milligram	mg	Colesterolo
carbohydrates-gram	g	Carboidrati totali
sucrose-gram	g	Zuccheri
protein-gram	g	Proteine
fibers-gram	g	Fibre alimentari
water-gram	g	Contenuto d'acqua
sodium-chloride-gram	g	Sale
alcohol-volume-percent	%	Contenuto alcolico

Vitamine

Campo	Unità	Vitamina
vitamine-a1-microgram	mcg	Vitamina A (retinolo)
vitamine-b1-microgram	mcg	Vitamina B1 (tiamina)
vitamine-b2-microgram	mcg	Vitamina B2 (riboflavina)
vitamine-b6-microgram	mcg	Vitamina B6 (piridossina)
vitamine-b12-microgram	mcg	Vitamina B12 (cobalamina)
vitamine-c-milligram	mg	Vitamina C
vitamine-d-microgram	mcg	Vitamina D
vitamine-e-microgram	mcg	Vitamina E (tocoferolo)
vitamine-h-microgram	mcg	Vitamina H (biotina)
vitamine-k-microgram	mcg	Vitamina K
beta-carotene-milligram	mg	Beta-carotene
niacin-milligram	mg	Niacina (B3)
pantohen-milligram	mg	Acido pantotenico (B5)
folic-acid-microgram	mcg	Acido folico (B9)

Minerali

Campo	Unità	Minerale
sodium-milligram	mg	Sodio
potassium-milligram	mg	Potassio
chlorine-milligram	mg	Cloro
calcium-milligram	mg	Calcio
magnesium-milligram	mg	Magnesio
phosphorus-milligram	mg	Fosforo
iron-milligram	mg	Ferro
zinc-microgram	mcg	Zinco
copper-microgram	mcg	Rame
manganese-microgram	mcg	Manganese
flouride-microgram	mcg	Fluoruro
iodine-microgram	mcg	Iodio

Altri composti

Campo	Unità	Descrizione
purine-milligram	mg	Contenuto di purine
uric-acid-milligram	mg	Acido urico

---

Le fonti dei dati alla base di questi valori sono descritte in Metodologia › Fonti dei dati.