Guide API - Base de données sur le Fichier canadien sur les éléments nutritifs (FCÉN)
Table des matières
Introduction
Le Fichier canadien sur les éléments nutritifs (FCÉN) est la base de données de référence sur la composition des aliments qui nous informe de la quantité des éléments nutritifs dans les aliments couramment consommés au Canada.
Cette interface de programmation d'applications (API) permet aux concepteurs d'accéder à ces renseignements en format JSON et XML afin de les utiliser dans leurs propres applications. L'adresse URI de base sur le Fichier canadien sur les éléments nutritifs est https://aliments-nutrition.canada.ca/api/fichier-canadien-elements-nutritifs/ et vous pouvez y ajouter des paramètres. Toute requête est effectuée par l'entremise de cette adresse URI.
Aliment
Contient la description et le code de chaque aliment. Un aliment ne peut être davantage décomposé en ingrédients.
Paramètres
Il y a trois paramètres dans la requête : id, lang et type.
| Paramètre | Définition | Valeur | Requis? | Note |
|---|---|---|---|---|
| api/fichier-canadien-elements-nutritifs/food/?id= | Affiche les détails de l'aliment selon le code de l'aliment spécifié dans la requête. |
|
Oui | |
| api/fichier-canadien-elements-nutritifs/food/?lang=fr | Modifie la langue du résultat. |
|
Non, mais l'anglais est la langue par défaut si elle n'est pas spécifiée. | Détermine si le résultat est affiché en anglais ou en français. |
| api/fichier-canadien-elements-nutritifs/food/?type=json | Modifie le format du résultat. |
|
Non, mais JSON est le format par défaut s'il n'est pas spécifié. | Détermine si le résultat est en format JSON ou XML. |
La liste des aliments peut être accédée aux adresses URI suivantes :
Contenu du résultat
Le résultat contient un ou plusieurs objets.
Chaque objet aliment contient les valeurs suivantes :
| Code | Valeur |
|---|---|
| food_code | Le code attribué à un aliment. |
| food_description | Le nom complet de l'aliment. |
Exemple de résultat
{"food_code":112,"food_description":"Lait, concentré, écrémé, conserve, non dilué, 0.2% M.G."}
Exemple de jQuery
Exemple d'une fonctionnalité qui recherche un aliment selon le code d'un aliment et la langue sélectionnée :
function getFood(id, lang) {
var base = 'https://aliments-nutrition.canada.ca';
var uri = base + '/api/fichier-canadien-elements-nutritifs/food/?lang=' + lang + '&id=' + id;
$.ajax({
url:uri,
type:'GET',
Accept:"application/json",
dataType: 'json',
success:function(data){
console.log(data.food_description);
var frag = document.createDocumentFragment();
var h2 = document.createElement("h2");
var FoodName = document.createTextNode(data.food_description);
var p = document.createElement("p");
var text = document.createTextNode(data.panels[0].text);
h2.appendChild(FoodName);
p.appendChild(text);
frag.appendChild(h2);
frag.appendChild(p);
$("#responses")[0].appendChild(frag);
},
error:function(error){
},
});
return;
};
Nom des éléments nutritifs
La liste des éléments nutritifs.
Paramètres
Il y a trois paramètres dans la requête : id, lang et type.
| Paramètre | Définition | Valeur | Requis? | Note |
|---|---|---|---|---|
| api/fichier-canadien-elements-nutritifs/nutrientname/?id= | Affiche l'élément nutritif selon le numéro d'identification de l'élément nutritif spécifié dans la requête. |
|
Oui | |
| api/fichier-canadien-elements-nutritifs/nutrientname/?lang=fr | Modifie la langue du résultat. |
|
Non, mais l'anglais est la langue par défaut si elle n'est pas spécifiée. | Détermine si le résultat est affiché en anglais ou en français. |
| api/fichier-canadien-elements-nutritifs/nutrientname/?type=json | Modifie le format du résultat. |
|
Non, mais JSON est le format par défaut s'il n'est pas spécifié. | Détermine si le résultat est en format JSON ou XML. |
La liste des éléments nutritifs peut être accédée aux adresses URI suivantes :
Contenu du résultat
Le résultat contient un ou plusieurs objets.
Chaque objet élément nutritif contient les valeurs suivantes :
| Code | Valeur |
|---|---|
| nutrient_name_id | Le numéro d'identification attribué à un élément nutritif. |
| nutrient_code | Le code attribué à un élément nutritif. |
| nutrient_symbol | Le symbole ou l'abréviation des éléments nutritifs. Ces symboles peuvent être différents de la nomenclature internationale. |
| unit | L'unité de mesure (ex: mg, g, mcg). |
| nutrient_name | Le nom de l'élément nutritif. |
| tagname | Un système d'abréviation des constituants alimentaires développé par le réseau international des systèmes de données sur l'alimentation (INFOODS) pour faciliter l'échange d'information au niveau international. |
| nutrient_decimals | Le nombre de décimales utilisées pour arrondir la valeur des éléments nutritifs. |
| nutrient_web_order | L'ordre d'affichage des éléments nutritifs. |
| nutrient_web_name | Le nom de l'élément nutritif pour le WEB. |
| nutrient_group_id | Le numéro d'identification d'un groupe d'éléments nutritifs. |
Exemple de résultat
{"nutrient_name_id":837,"nutrient_symbol":"LUT+ZEA","nutrient_name":"LUTÉINE ET ZÉAXANTHINE","unit":"µg","nutrient_code":338,"tagname":"LUT+ZEA","nutrient_decimals":0,"nutrient_web_order":20,"nutrient_web_name":"Lutéine et zéaxanthine","nutrient_group_id":7}
Exemple de jQuery
Exemple d'une fonctionnalité qui recherche un élément nutritif selon le numéro d'identification d'un élément nutritif et la langue sélectionnée :
function getNutrientName(id, lang) {
var base = 'https://aliments-nutrition.canada.ca';
var uri = base + '/api/fichier-canadien-elements-nutritifs/nutrientname/?lang=' + lang + '&id=' + id;
$.ajax({
url:uri,
type:'GET',
Accept:"application/json",
dataType: 'json',
success:function(data){
console.log(data.nutrient_name);
var frag = document.createDocumentFragment();
var h2 = document.createElement("h2");
var NutrientName = document.createTextNode(data.nutrient_name);
var p = document.createElement("p");
var text = document.createTextNode(data.panels[0].text);
h2.appendChild(NutrientName);
p.appendChild(text);
frag.appendChild(h2);
frag.appendChild(p);
$("#responses")[0].appendChild(frag);
},
error:function(error){
},
});
return;
};
Groupe d'éléments nutritifs
La liste des groupes d'éléments nutritifs basés sur les similarités des éléments nutritifs.
Paramètres
Il y a trois paramètres dans la requête : id, lang et type.
| Paramètre | Définition | Valeur | Requis? | Note |
|---|---|---|---|---|
| api/fichier-canadien-elements-nutritifs/nutrientgroup/?id= | Affiche le groupe d'éléments nutritifs selon le numéro d'identification du groupe d'éléments nutritifs spécifié dans la requête. |
|
Oui | |
| api/fichier-canadien-elements-nutritifs/nutrientgroup/?lang=fr | Modifie la langue du résultat. |
|
Non, mais l'anglais est la langue par défaut si elle n'est pas spécifiée. | Détermine si le résultat est affiché en anglais ou en français. |
| api/fichier-canadien-elements-nutritifs/nutrientgroup/?type=json | Modifie le format du résultat. |
|
Non, mais JSON est le format par défaut s'il n'est pas spécifié. | Détermine si le résultat est en format JSON ou XML. |
La liste des groupes d'éléments nutritifs peut être accédée aux adresses URI suivantes :
Contenu du résultat
Le résultat contient un ou plusieurs objets.
Chaque objet groupe d'éléments nutritifs contient les valeurs suivantes :
| Code | Valeur |
|---|---|
| nutrient_group_id | Le numéro d'identification attribué à un groupe d'éléments nutritifs. |
| nutrient_group_name | Le nom d'un groupe d'éléments nutritifs. |
| nutrient_group_order | L'ordre d'affichage des groupes d'éléments nutritifs. |
Exemple de résultat
{"nutrient_group_id":2,"nutrient_group_name":"Autres glucides","nutrient_group_order":2}
Exemple de jQuery
Exemple d'une fonctionnalité qui recherche un groupe d'éléments nutritifs selon le numéro d'identification d'un groupe d'éléments nutritifs et la langue sélectionnée :
function getNutrientGroup(id, lang) {
var base = 'https://aliments-nutrition.canada.ca';
var uri = base + '/api/fichier-canadien-elements-nutritifs/nutrientgroup/?lang=' + lang + '&id=' + id;
$.ajax({
url:uri,
type:'GET',
Accept:"application/json",
dataType: 'json',
success:function(data){
console.log(data.nutrient_group_name);
var frag = document.createDocumentFragment();
var h2 = document.createElement("h2");
var NutrientGroup = document.createTextNode(data.nutrient_group_name);
var p = document.createElement("p");
var text = document.createTextNode(data.panels[0].text);
h2.appendChild(NutrientGroup);
p.appendChild(text);
frag.appendChild(h2);
frag.appendChild(p);
$("#responses")[0].appendChild(frag);
},
error:function(error){
},
});
return;
};
Source d'éléments nutritifs
La liste des sources et/ou types d'éléments nutritifs.
Paramètres
Il y a trois paramètres dans la requête : id, lang et type.
| Paramètre | Définition | Valeur | Requis? | Note |
|---|---|---|---|---|
| api/fichier-canadien-elements-nutritifs/nutrientsource/?id= | Affiche la source d'éléments nutritifs selon le numéro d'identification de la source d'éléments nutritifs spécifié dans la requête. |
|
Oui | |
| api/fichier-canadien-elements-nutritifs/nutrientsource/?lang=fr | Modifie la langue du résultat. |
|
Non, mais l'anglais est la langue par défaut si elle n'est pas spécifiée. | Détermine si le résultat est affiché en anglais ou en français. |
| api/fichier-canadien-elements-nutritifs/nutrientsource/?type=json | Modifie le format du résultat. |
|
Non, mais JSON est le format par défaut s'il n'est pas spécifié. | Détermine si le résultat est en format JSON ou XML. |
La liste des sources d'éléments nutritifs peut être accédée aux adresses URI suivantes :
Contenu du résultat
Le résultat contient un ou plusieurs objets.
Chaque objet source d'éléments nutritifs contient les valeurs suivantes :
| Code | Valeur |
|---|---|
| nutrient_source_id | Le numéro d'identification attribué à une source d'éléments nutritifs. |
| nutrient_source_description | La description d'une source d'éléments nutritifs. |
| nutrient_source_code | Le code qui identifie une source d'éléments nutritifs au Canada. |
Exemple de résultat
{"nutrient_source_id":5,"nutrient_source_description":"Nutriment imputé d'un aliment semblable du USDA","nutrient_source_code":5}
Exemple de jQuery
Exemple d'une fonctionnalité qui recherche la source d'éléments nutritifs selon le code d'une source d'éléments nutritifs et la langue sélectionnée :
function getNutrientSource(id, lang) {
var base = 'https://aliments-nutrition.canada.ca';
var uri = base + '/api/fichier-canadien-elements-nutritifs/nutrientsource/?lang=' + lang + '&id=' + id;
$.ajax({
url:uri,
type:'GET',
Accept:"application/json",
dataType: 'json',
success:function(data){
console.log(data.nutrient_source_description);
var frag = document.createDocumentFragment();
var h2 = document.createElement("h2");
var NutrientSource = document.createTextNode(data.nutrient_source_description);
var p = document.createElement("p");
var text = document.createTextNode(data.panels[0].text);
h2.appendChild(NutrientSource);
p.appendChild(text);
frag.appendChild(h2);
frag.appendChild(p);
$("#responses")[0].appendChild(frag);
},
error:function(error){
},
});
return;
};
Teneur en élément nutritif
Les quantités des éléments nutritifs pour 100 g de portion comestible, pour chaque aliment.
Paramètres
Il y a trois paramètres dans la requête : id, lang et type.
| Paramètre | Définition | Valeur | Requis? | Note |
|---|---|---|---|---|
| api/fichier-canadien-elements-nutritifs/nutrientamount/?id= | Affiche les teneurs en élément nutritif selon le code de l'aliment spécifié dans la requête. |
|
Oui | |
| api/fichier-canadien-elements-nutritifs/nutrientamount/?lang=fr | Modifie la langue du résultat. |
|
Non, mais l'anglais est la langue par défaut si elle n'est pas spécifiée. | Détermine si le résultat est affiché en anglais ou en français. |
| api/fichier-canadien-elements-nutritifs/nutrientamount/?type=json | Modifie le format du résultat. |
|
Non, mais JSON est le format par défaut s'il n'est pas spécifié. | Détermine si le résultat est en format JSON ou XML. |
La liste des teneurs en éléments nutritifs peut être accédée aux adresses URI suivantes :
Contenu du résultat
Le résultat contient un ou plusieurs objets.
Chaque objet teneur en élément nutritif contient les valeurs suivantes :
| Code | Valeur |
|---|---|
| food_code | Le code attribué à chaque aliment. |
| nutrient_value | Valeur moyenne dans une portion de 100g de portion comestible (le nombre de décimale ne reflète pas l'exactitude des données). |
| standard_error | L'écart-type de la moyenne. |
| number_observation | Le nombre d'échantillons utilisés pour une étude. |
| nutrient_name_id | Le numéro d'identification d'un élément nutritif. |
| nutrient_web_name | Le nom de l'élément nutritif pour le WEB. |
| unit | L'unité de mesure (ex: mg, g, mcg). |
| nutrient_decimals | Le nombre de décimales utilisées pour arrondir la valeur des éléments nutritifs. |
| nutrient_web_order | L'ordre d'affichage des éléments nutritifs. |
| nutrient_source_id | Le numéro d'identification d'une source d'éléments nutritifs. |
| nutrient_source_code | Le code qui identifie une source d'éléments nutritifs au Canada. |
| nutrient_source_description | La description d'une source d'éléments nutritifs. |
Exemple de résultat
[{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":221,"nutrient_web_name":"Alcool","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":262,"nutrient_web_name":"Caféine","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":263,"nutrient_web_name":"Théobromine","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":621,"nutrient_web_name":"22:6n-6","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":631,"nutrient_web_name":"22:5n-3","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":827,"nutrient_web_name":"20:3","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":832,"nutrient_web_name":"18:3n6cccn-6","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":854,"nutrient_web_name":"20:3n-6","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":861,"nutrient_web_name":"20:3n-3","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":607,"nutrient_web_name":"4:0","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":608,"nutrient_web_name":"6:0","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":609,"nutrient_web_name":"8:0","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":610,"nutrient_web_name":"10:0","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":620,"nutrient_web_name":"20:4","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":627,"nutrient_web_name":"18:4","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":629,"nutrient_web_name":"20:5n-3","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":630,"nutrient_web_name":"22:1","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":823,"nutrient_web_name":"20:2cc","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":836,"nutrient_web_name":"Lycopène","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":840,"nutrient_web_name":"22:1c","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":841,"nutrient_web_name":"18:3i","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":852,"nutrient_web_name":"22:1t","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.0,"standard_error":0,"number_observation":0,"nutrient_name_id":855,"nutrient_web_name":"20:4n-6","nutrient_source_id":12},
{"food_code":5,"nutrient_value":0.001,"standard_error":0,"number_observation":0,"nutrient_name_id":611,"nutrient_web_name":"12:0","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.005,"standard_error":0,"number_observation":0,"nutrient_name_id":612,"nutrient_web_name":"14:0","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.01465,"standard_error":0,"number_observation":0,"nutrient_name_id":339,"nutrient_web_name":"Vitamine D","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.024,"standard_error":0,"number_observation":0,"nutrient_name_id":626,"nutrient_web_name":"16:1","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0269,"standard_error":0,"number_observation":0,"nutrient_name_id":501,"nutrient_web_name":"Tryptophane","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0275,"standard_error":0,"number_observation":0,"nutrient_name_id":628,"nutrient_web_name":"20:1","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0345,"standard_error":0,"number_observation":0,"nutrient_name_id":507,"nutrient_web_name":"Cystine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0358,"standard_error":0,"number_observation":0,"nutrient_name_id":418,"nutrient_web_name":"Vitamine B-12","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.038,"standard_error":0,"number_observation":0,"nutrient_name_id":506,"nutrient_web_name":"Méthionine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.055,"standard_error":0,"number_observation":0,"nutrient_name_id":509,"nutrient_web_name":"Tyrosine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.056,"standard_error":0,"number_observation":0,"nutrient_name_id":512,"nutrient_web_name":"Histidine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0679,"standard_error":0,"number_observation":0,"nutrient_name_id":415,"nutrient_web_name":"Vitamine B-6","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.07236,"standard_error":0,"number_observation":0,"nutrient_name_id":502,"nutrient_web_name":"Thréonine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.074,"standard_error":0,"number_observation":0,"nutrient_name_id":518,"nutrient_web_name":"Sérine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.076,"standard_error":0,"number_observation":0,"nutrient_name_id":516,"nutrient_web_name":"Glycine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.085,"standard_error":0,"number_observation":0,"nutrient_name_id":404,"nutrient_web_name":"Thiamine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0879,"standard_error":0,"number_observation":0,"nutrient_name_id":605,"nutrient_web_name":"Acides gras trans totaux","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.091,"standard_error":0,"number_observation":0,"nutrient_name_id":513,"nutrient_web_name":"Alanine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0939,"standard_error":0,"number_observation":0,"nutrient_name_id":312,"nutrient_web_name":"Cuivre, Cu","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0974,"standard_error":0,"number_observation":0,"nutrient_name_id":405,"nutrient_web_name":"Riboflavine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.098,"standard_error":0,"number_observation":0,"nutrient_name_id":508,"nutrient_web_name":"Phénylalanine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.0999,"standard_error":0,"number_observation":0,"nutrient_name_id":503,"nutrient_web_name":"Isoleucine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.1064,"standard_error":0,"number_observation":0,"nutrient_name_id":510,"nutrient_web_name":"Valine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.117,"standard_error":0,"number_observation":0,"nutrient_name_id":505,"nutrient_web_name":"Lysine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.119,"standard_error":0,"number_observation":0,"nutrient_name_id":517,"nutrient_web_name":"Proline","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.128,"standard_error":0,"number_observation":0,"nutrient_name_id":511,"nutrient_web_name":"Arginine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.156,"standard_error":0,"number_observation":0,"nutrient_name_id":504,"nutrient_web_name":"Leucine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.156,"standard_error":0,"number_observation":0,"nutrient_name_id":614,"nutrient_web_name":"18:0","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.24,"standard_error":0,"number_observation":0,"nutrient_name_id":514,"nutrient_web_name":"Acide aspartique","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.2453,"standard_error":0,"number_observation":0,"nutrient_name_id":315,"nutrient_web_name":"Manganèse, Mn","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.26,"standard_error":0,"number_observation":0,"nutrient_name_id":410,"nutrient_web_name":"Acide pantothénique","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.333,"standard_error":0,"number_observation":0,"nutrient_name_id":619,"nutrient_web_name":"18:3","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.333,"standard_error":0,"number_observation":0,"nutrient_name_id":831,"nutrient_web_name":"18:3n3cccn-3","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.337,"standard_error":0,"number_observation":0,"nutrient_name_id":319,"nutrient_web_name":"Rétinol","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.4451,"standard_error":0,"number_observation":0,"nutrient_name_id":309,"nutrient_web_name":"Zinc, Zn","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.448,"standard_error":0,"number_observation":0,"nutrient_name_id":613,"nutrient_web_name":"16:0","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.474,"standard_error":0,"number_observation":0,"nutrient_name_id":515,"nutrient_web_name":"Acide glutamique","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.632,"standard_error":0,"number_observation":0,"nutrient_name_id":606,"nutrient_web_name":"Acides gras saturés totaux","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.68391,"standard_error":0,"number_observation":0,"nutrient_name_id":323,"nutrient_web_name":"Tocophérol, alpha","nutrient_source_id":102},
{"food_code":5,"nutrient_value":0.8868,"standard_error":0,"number_observation":0,"nutrient_name_id":303,"nutrient_web_name":"Fer, Fe","nutrient_source_id":102},
{"food_code":5,"nutrient_value":1.22,"standard_error":0,"number_observation":0,"nutrient_name_id":291,"nutrient_web_name":"Fibres alimentaires totales","nutrient_source_id":102},
{"food_code":5,"nutrient_value":1.35165,"standard_error":0,"number_observation":0,"nutrient_name_id":834,"nutrient_web_name":"Alpha-carotène","nutrient_source_id":102},
{"food_code":5,"nutrient_value":1.3517,"standard_error":0,"number_observation":0,"nutrient_name_id":835,"nutrient_web_name":"Bêta-cryptozanthine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":1.5464,"standard_error":0,"number_observation":0,"nutrient_name_id":207,"nutrient_web_name":"Cendres","nutrient_source_id":102},
{"food_code":5,"nutrient_value":1.557,"standard_error":0,"number_observation":0,"nutrient_name_id":406,"nutrient_web_name":"Niacine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":1.786,"standard_error":0,"number_observation":0,"nutrient_name_id":617,"nutrient_web_name":"18:1","nutrient_source_id":102},
{"food_code":5,"nutrient_value":1.815,"standard_error":0,"number_observation":0,"nutrient_name_id":618,"nutrient_web_name":"18:2","nutrient_source_id":102},
{"food_code":5,"nutrient_value":1.841,"standard_error":0,"number_observation":0,"nutrient_name_id":645,"nutrient_web_name":"Acides gras monoinsaturés totaux","nutrient_source_id":102},
{"food_code":5,"nutrient_value":2.00533,"standard_error":0,"number_observation":0,"nutrient_name_id":409,"nutrient_web_name":"Niacine, équivalents","nutrient_source_id":4},
{"food_code":5,"nutrient_value":2.018,"standard_error":0,"number_observation":0,"nutrient_name_id":601,"nutrient_web_name":"Cholestérol","nutrient_source_id":102},
{"food_code":5,"nutrient_value":2.156,"standard_error":0,"number_observation":0,"nutrient_name_id":646,"nutrient_web_name":"Acides gras polyinsaturés totaux","nutrient_source_id":102},
{"food_code":5,"nutrient_value":2.839,"standard_error":0,"number_observation":0,"nutrient_name_id":269,"nutrient_web_name":"Sucres totaux","nutrient_source_id":102},
{"food_code":5,"nutrient_value":3.118,"standard_error":0,"number_observation":0,"nutrient_name_id":203,"nutrient_web_name":"Protéines","nutrient_source_id":102},
{"food_code":5,"nutrient_value":4.833,"standard_error":0,"number_observation":0,"nutrient_name_id":204,"nutrient_web_name":"Lipides totaux","nutrient_source_id":102},
{"food_code":5,"nutrient_value":4.91,"standard_error":0,"number_observation":0,"nutrient_name_id":401,"nutrient_web_name":"Vitamine C","nutrient_source_id":102},
{"food_code":5,"nutrient_value":4.99,"standard_error":0,"number_observation":0,"nutrient_name_id":814,"nutrient_web_name":"Équivalents d'activité du rétinol (EAR)","nutrient_source_id":102},
{"food_code":5,"nutrient_value":5.486,"standard_error":0,"number_observation":0,"nutrient_name_id":317,"nutrient_web_name":"Sélénium, Se","nutrient_source_id":102},
{"food_code":5,"nutrient_value":6.712,"standard_error":0,"number_observation":0,"nutrient_name_id":431,"nutrient_web_name":"Acide folique, forme synthétique","nutrient_source_id":102},
{"food_code":5,"nutrient_value":9.846,"standard_error":0,"number_observation":0,"nutrient_name_id":205,"nutrient_web_name":"Glucides","nutrient_source_id":102},
{"food_code":5,"nutrient_value":14.469,"standard_error":0,"number_observation":0,"nutrient_name_id":304,"nutrient_web_name":"Magnésium, Mg","nutrient_source_id":102},
{"food_code":5,"nutrient_value":15.247,"standard_error":0,"number_observation":0,"nutrient_name_id":430,"nutrient_web_name":"Vitamine K","nutrient_source_id":102},
{"food_code":5,"nutrient_value":18.151,"standard_error":0,"number_observation":0,"nutrient_name_id":301,"nutrient_web_name":"Calcium, Ca","nutrient_source_id":102},
{"food_code":5,"nutrient_value":20.688,"standard_error":0,"number_observation":0,"nutrient_name_id":806,"nutrient_web_name":"Folates présents naturellement","nutrient_source_id":102},
{"food_code":5,"nutrient_value":27.4,"standard_error":0,"number_observation":0,"nutrient_name_id":417,"nutrient_web_name":"Folacine, totale","nutrient_source_id":102},
{"food_code":5,"nutrient_value":32.0984,"standard_error":0,"number_observation":0,"nutrient_name_id":815,"nutrient_web_name":"Équivalents de folate alimentaire (EFA)","nutrient_source_id":2},
{"food_code":5,"nutrient_value":49.817,"standard_error":0,"number_observation":0,"nutrient_name_id":305,"nutrient_web_name":"Phosphore, P","nutrient_source_id":102},
{"food_code":5,"nutrient_value":51.851,"standard_error":0,"number_observation":0,"nutrient_name_id":321,"nutrient_web_name":"Bêta-carotène","nutrient_source_id":102},
{"food_code":5,"nutrient_value":61.149,"standard_error":0,"number_observation":0,"nutrient_name_id":837,"nutrient_web_name":"Lutéine et zéaxanthine","nutrient_source_id":102},
{"food_code":5,"nutrient_value":80.683,"standard_error":0,"number_observation":0,"nutrient_name_id":255,"nutrient_web_name":"Eau","nutrient_source_id":102},
{"food_code":5,"nutrient_value":92.0,"standard_error":0,"number_observation":0,"nutrient_name_id":208,"nutrient_web_name":"Énergie (kcal)","nutrient_source_id":102},
{"food_code":5,"nutrient_value":148.319,"standard_error":0,"number_observation":0,"nutrient_name_id":306,"nutrient_web_name":"Potassium, K","nutrient_source_id":102},
{"food_code":5,"nutrient_value":385.0,"standard_error":0,"number_observation":0,"nutrient_name_id":268,"nutrient_web_name":"Énergie (kJ)","nutrient_source_id":2},
{"food_code":5,"nutrient_value":428.349,"standard_error":0,"number_observation":0,"nutrient_name_id":307,"nutrient_web_name":"Sodium, Na","nutrient_source_id":102}]
Exemple de jQuery
Exemple d'une fonctionnalité qui recherche les teneurs en éléments nutritifs selon le code d'un aliment et la langue spécifiée :
function getNutrientAmount(id, lang) {
var base = 'https://aliments-nutrition.canada.ca';
var uri = base + '/api/fichier-canadien-elements-nutritifs/nutrientamount/?lang=' + lang + '&id=' + id;
$.ajax({
url:uri,
type:'GET',
Accept:"application/json",
dataType: 'json',
success:function(data){
console.log(data.nutrient_value);
var frag = document.createDocumentFragment();
var h2 = document.createElement("h2");
var NutrientValue = document.createTextNode(data.nutrient_value);
var p = document.createElement("p");
var text = document.createTextNode(data.panels[0].text);
h2.appendChild(NutrientValue);
p.appendChild(text);
frag.appendChild(h2);
frag.appendChild(p);
$("#responses")[0].appendChild(frag);
},
error:function(error){
},
});
return;
};
Portion comestible
Mesures et facteurs de conversion par aliment. Les facteurs sont utilisés (multiplier avec la valeur pour 100g) pour obtenir la valeur de l'élément nutritif pour la mesure donnée.
Paramètres
Il y a trois paramètres dans la requête : id, lang et type.
| Paramètre | Définition | Valeur | Requis? | Note |
|---|---|---|---|---|
| api/fichier-canadien-elements-nutritifs/servingsize/?id= | Affiche les portions comestibles selon le code de l'aliment spécifié dans la requête. |
|
Oui | |
| api/fichier-canadien-elements-nutritifs/servingsize/?lang=fr | Modifie la langue du résultat. |
|
Non, mais l'anglais est la langue par défaut si elle n'est pas spécifiée. | Détermine si le résultat est affiché en anglais ou en français. |
| api/fichier-canadien-elements-nutritifs/servingsize/?type=json | Modifie le format du résultat. |
|
Non, mais JSON est le format par défaut s'il n'est pas spécifié. | Détermine si le résultat est en format JSON ou XML. |
La liste des portions comestibles peut être accédée aux adresses URI suivantes :
Contenu du résultat
Le résultat contient un ou plusieurs objets.
Chaque objet portion comestible contient les valeurs suivantes :
| Code | Valeur |
|---|---|
| food_code | Le code attribué à chaque aliment. |
| food_description | Le nom complet de l'aliment. |
| conversion_factor_value | Le facteur utilisé (multiplier avec la valeur pour 100g) afin d'obtenir la valeur de l'élément nutritif pour la mesure donnée. |
| measure_name | La description de la mesure. |
Exemple de résultat
[{"conversion_factor_value":1.0397,"food_code":21,"food_description":"Fromage camembert","measure_name":"100ml"},
{"conversion_factor_value":2.59932,"food_code":21,"food_description":"Fromage camembert","measure_name":"250ml"},
{"conversion_factor_value":0.5,"food_code":21,"food_description":"Fromage camembert","measure_name":"50g"}]
Exemple de jQuery
Exemple d'une fonctionnalité qui recherche les portions comestibles selon le code d'un aliment et la langue spécifiée :
function getServingSize(id, lang) {
var base = 'https://aliments-nutrition.canada.ca';
var uri = base + '/api/fichier-canadien-elements-nutritifs/servingsize/?lang=' + lang + '&id=' + id;
$.ajax({
url:uri,
type:'GET',
Accept:"application/json",
dataType: 'json',
success:function(data){
console.log(data.conversion_factor_value);
var frag = document.createDocumentFragment();
var h2 = document.createElement("h2");
var Serving = document.createTextNode(data.conversion_factor_value);
var p = document.createElement("p");
var text = document.createTextNode(data.panels[0].text);
h2.appendChild(Serving);
p.appendChild(text);
frag.appendChild(h2);
frag.appendChild(p);
$("#responses")[0].appendChild(frag);
},
error:function(error){
},
});
return;
};
Portion non comestible
Désigne la partie non comestible d'une portion, pour chaque aliment.
Paramètres
Il y a quatre paramètres dans la requête : id, lang et type.
| Paramètre | Définition | Valeur | Requis? | Note |
|---|---|---|---|---|
| api/fichier-canadien-elements-nutritifs/refuseamount//?id= | Affiche la ou les portions non comestibles selon le code de l'aliment spécifié dans la requête. |
|
Oui | |
| api/fichier-canadien-elements-nutritifs/refuseamount//?lang=fr | Modifie la langue du résultat. |
|
Non, mais l'anglais est la langue par défaut si elle n'est pas spécifiée. | Détermine si le résultat est affiché en anglais ou en français. |
| api/fichier-canadien-elements-nutritifs/refuseamount//?type=json | Modifie le format du résultat. |
|
Non, mais JSON est le format par défaut s'il n'est pas spécifié. | Détermine si le résultat est en format JSON ou XML. |
La liste des portions non comestibles peut être accédée aux adresses URI suivantes :
Contenu du résultat
Le résultat contient un ou plusieurs objets.
Chaque objet portion non comestible contient les valeurs suivantes :
| Code | Valeur |
|---|---|
| food_code | Le code attribué à chaque aliment. |
| food_description | Le nom complet de l'aliment. |
| refuse_amount | Pourcentage des portions non comestibles. |
| refuse_name | La description de la portion non comestible. |
Exemple de résultat
[{"refuse_amount":0.0,"food_code":20,"food_description":"Fromage brie","refuse_name":"portion non comestible totale"}]
Exemple de jQuery
Exemple d'une fonctionnalité qui recherche les portions non comestibles selon le code d'un aliment et la langue sélectionnée :
function getRefuse(id, lang) {
var base = 'https://aliments-nutrition.canada.ca';
var uri = base + '/api/fichier-canadien-elements-nutritifs/refuseamount/?lang=' + lang + '&id=' + id;
$.ajax({
url:uri,
type:'GET',
Accept:"application/json",
dataType: 'json',
success:function(data){
console.log(data.refuse_name);
var frag = document.createDocumentFragment();
var h2 = document.createElement("h2");
var Refuse = document.createTextNode(data.refuse_name);
var p = document.createElement("p");
var text = document.createTextNode(data.panels[0].text);
h2.appendChild(Refuse);
p.appendChild(text);
frag.appendChild(h2);
frag.appendChild(p);
$("#responses")[0].appendChild(frag);
},
error:function(error){
},
});
return;
};
Rendement
Contient les rendements provenant des portions non comestibles et/ou des pertes de cuisson de certains aliments. Ces rendements sont souvent consultés à des fins d'inventaires alimentaires.
Paramètres
Il y a trois paramètres dans la requête : id, lang et type.
| Paramètre | Définition | Valeur | Requis? | Note |
|---|---|---|---|---|
| api/fichier-canadien-elements-nutritifs/yieldamount/?id= | Affiche le ou les rendements selon le code de l'aliment spécifié dans la requête. |
|
Oui | |
| api/fichier-canadien-elements-nutritifs/yieldamount/?lang=fr | Modifie la langue du résultat. |
|
Non, mais l'anglais est la langue par défaut si elle n'est pas spécifiée. | Détermine si le résultat est affiché en anglais ou en français. |
| api/fichier-canadien-elements-nutritifs/yieldamount/?type=json | Modifie le format du résultat. |
|
Non, mais JSON est le format par défaut s'il n'est pas spécifié. | Détermine si le résultat est en format JSON ou XML. |
La liste des rendements peut être accédée aux adresses URI suivantes :
Contenu du résultat
Le résultat contient un ou plusieurs objets.
Chaque objet rendement contient les valeurs suivantes :
| Code | Valeur |
|---|---|
| food_code | Le code attribué à chaque aliment. |
| food_description | Le nom complet de l'aliment. |
| yield_amount | Le rendement provenant des portions non comestibles et pertes de cuisson. |
| yield_name | La description du rendement. |
Exemple de résultat
[{"yield_amount":1.318,"food_code":57,"food_description":"Garniture à dessert (non laitière), poudre","yield_name":"quantité requise pour préparer 15ml"},
{"yield_amount":21.959,"food_code":57,"food_description":"Garniture à dessert (non laitière), poudre","yield_name":"quantité requise pour préparer 250ml"}]
Exemple de jQuery
Exemple d'une fonctionnalité qui recherche les rendements selon le code d'un aliment et la langue sélectionnée :
function getYield(id, lang) {
var base = 'https://aliments-nutrition.canada.ca';
var uri = base + '/api/fichier-canadien-elements-nutritifs/yieldamount/?lang=' + lang + '&id=' + id;
$.ajax({
url:uri,
type:'GET',
Accept:"application/json",
dataType: 'json',
success:function(data){
console.log(data.yield_amount);
var frag = document.createDocumentFragment();
var h2 = document.createElement("h2");
var Yield = document.createTextNode(data.yield_amount);
var p = document.createElement("p");
var text = document.createTextNode(data.panels[0].text);
h2.appendChild(Yield);
p.appendChild(text);
frag.appendChild(h2);
frag.appendChild(p);
$("#responses")[0].appendChild(frag);
},
error:function(error){
},
});
return;
};