Open Food Facts
Description
Recherche de produits du commerce dans la base collaborative Open Food Facts (plus de 3 millions de produits), par texte libre ou par catégorie, avec import direct dans la bibliothèque personnelle.
Objectif
Trouver un produit précis (marque incluse) absent de la base CIQUAL, en s'appuyant sur une base collaborative internationale plutôt que sur la seule composition générique française.
Prérequis
- Permissions : aucune.
- Connexion : requise pour chaque recherche ; les résultats déjà obtenus dans les 12 dernières heures peuvent s'afficher depuis le cache en cas d'échec réseau.
- Configuration : aucune obligatoire. Si un fournisseur IA est configuré, l'import d'un produit déclenche automatiquement un enrichissement en arrière-plan (voir Limites).
Comment l'utiliser
- Ouvrir Open Food Facts depuis le chip « Découvrir » du Journal ou de la Bibliothèque d'aliments.
- Taper une recherche libre, ou toucher l'un des 9 chips de catégorie (Céréales, Légumineuses, Viandes, Poissons, Fruits, Légumes, Produits laitiers, Corps gras, Boissons).
- Un champ de recherche actif propose un menu déroulant des 12 dernières recherches effectuées.
- Les résultats sont triés par pertinence pour une recherche texte (nom exact, marque exacte, puis préfixe, inclusion, et enfin présence dans les ingrédients) ; les résultats par catégorie ne sont pas re-triés.
- Toucher « Importer » sur une fiche l'ajoute à la bibliothèque personnelle ; le bouton indique ensuite que le produit est déjà importé.
- Un badge « hors-ligne » apparaît si les résultats affichés proviennent du cache local plutôt que d'une réponse réseau fraîche.
Options
| Catégorie | Tag Open Food Facts |
|---|---|
| 🌾 Céréales | en:cereals-and-their-products |
| 🌱 Légumineuses | en:legumes |
| 🥩 Viandes | en:meats |
| 🐟 Poissons | en:seafood |
| 🍎 Fruits | en:fruits |
| 🥦 Légumes | en:vegetables |
| 🥛 Produits laitiers | en:dairy-products |
| 🧈 Corps gras | en:fats |
| 🥤 Boissons | en:beverages |
Paramètres associés
Le fournisseur IA configuré dans Paramètres détermine si l'enrichissement automatique post-import est déclenché.
Données utilisées
| Donnée | Détail |
|---|---|
| Requête de recherche | Envoyée à Open Food Facts (world.openfoodfacts.org), langue/pays fixés sur français |
| Cache de résultats | AsyncStorage, préfixe nutritor:off_cache:, durée de vie 12 h, utilisé uniquement en secours si la requête réseau échoue |
| Historique de recherche | nutritor:off_recent — 12 dernières requêtes texte, catégories non incluses |
| Fiche importée | Convertie en Food (identifiant off-<code produit>-001), 14 allergènes standard mappés depuis les tags Open Food Facts |
Résultat
Un ou plusieurs produits importés dans la bibliothèque personnelle, avec macros pour 100 g, allergènes détectés, et — si l'IA est configurée — un enrichissement automatique des champs avancés lancé en tâche de fond.
Fonctionnement hors connexion
Partiel : seuls des résultats déjà consultés dans les 12 dernières heures peuvent réapparaître via le cache si le réseau est indisponible au moment d'une recherche. Aucune nouvelle recherche n'est possible hors connexion. Voir Hors connexion.
Fonctionnement en ligne
Requis pour toute recherche ou tout import n'ayant pas de résultat déjà en cache.
Limites
- L'import déclenche un enrichissement IA automatique et silencieux si un fournisseur est configuré — contrairement à d'autres écrans où l'enrichissement est un bouton explicite, ici aucune confirmation n'est demandée ; seul le bandeau IA en bas d'écran signale la tâche en cours.
- Les produits sans donnée d'énergie (kcal ou kJ) exploitable sont exclus des résultats affichés.
- Le tri par pertinence ne s'applique qu'aux recherches textuelles ; les résultats obtenus via un chip de catégorie gardent l'ordre renvoyé par Open Food Facts.
- La conversion kJ → kcal (quand seule l'énergie en kJ est disponible) utilise un facteur fixe (÷ 4,184), ce qui peut légèrement différer de l'arrondi affiché sur l'emballage.
Erreurs possibles
- « Open Food Facts ne répond pas (délai dépassé) » — après 3 tentatives espacées (backoff progressif), sur dépassement du délai de 12 secondes par tentative.
- « Impossible de joindre Open Food Facts » — échec réseau après 3 tentatives ; si un résultat pour la même requête existe en cache (moins de 12 h), il est affiché avec le badge « hors-ligne » au lieu de cette erreur.
Dépannage
Aucun article dédié — voir Dépannage général si un comportement inattendu est rencontré.
FAQ
Pourquoi certains produits n'apparaissent-ils pas dans les résultats ?
Les produits sans valeur énergétique renseignée sur Open Food Facts sont automatiquement exclus des résultats.
Le badge « hors-ligne » signifie-t-il que je peux chercher sans connexion ?
Non, il indique seulement que le résultat affiché provient d'une recherche précédente mise en cache (moins de 12 h) ; une nouvelle recherche nécessite toujours une connexion.
Pourquoi une tâche IA se lance-t-elle après un import que je n'ai pas demandé ?
Si un fournisseur IA est configuré, chaque import depuis Open Food Facts déclenche automatiquement un enrichissement des champs avancés en arrière-plan — c'est un comportement normal, visible dans le bandeau IA.