Données

La base de données Open Beauty Facts est disponible sous licence Open Database License.
Les contenus individuels de la base de données sont disponibles sous licence Database Contents License.
Les images des produits sont disponibles sous licence Creative Commons Attribution ShareAlike licence. Les licences sont des licences libres qui autorisent l'utilisation et la reproduction du contenu à toutes fins, y compris l'utilisation commerciale, sous certaines conditions, en particulier l'attribution et le partage sous la même condition d'œuvres dérivées.

Merci de prendre connaissance des Conditions d'utilisation, de contribution et de réutilisation avant de réutiliser les données.

Nous aimerions savoir comment sont utilisées les données Open Beauty Facts. Ce n'est pas obligatoire mais nous apprécierions grandement si vous pouviez nous évoquer ce que vous en faites afin de le partager avec la communauté Open Beauty Facts.

Exports de données Open Beauty Facts

Les exports de base de données et fichiers de données sont réalisés quotidiennement, chaque nuit.

Des informations sur les différents champs des exports MongoDB et CSV sont disponibles sur https://world.openbeautyfacts.org/data/data-fields.txt

Export MongoDB

Les données concernant tous les produits sont disponibles à travers l'export MongoDB.

Lien

https://static.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.tar.gz

sha256sum

https://static.openbeautyfacts.org/data/sha256sum

md5sum

https://static.openbeautyfacts.org/data/md5sum

Export Delta

Des exports delta journaliers sont fournis pour les 14 jours précédents. La liste des fichiers delta actuellement disponibles est trouvable sur https://static.openbeautyfacts.org/data/delta/index.txt. Chaque ligne représente un fichier disponible à l'adresse https://static.openbeautyfacts.org/data/delta/{filename}. Le nom du fichier contient un horodatage UNIX du premier et du dernier changement apporté au fichier JSON, afin que les fichiers delta puissent être importés (après extraction) avec mongoimport par ordre alphabétique.

Veuillez noter qu'en raison de la nature de mongoexport , les fichiers delta ne peuvent pas vous renseigner sur les produits supprimés. Veuillez noter qu'en raison de la nature de mongoexport , les fichiers delta ne peuvent pas vous renseigner sur les produits supprimés.

Export CSV

Les données de tous les produits, ou seulement certains, peuvent être téléchargées au format CSV (utilisables dans OpenOffice, Excel et de nombreux logiciels) via le formulaire de recherche avancée.

Lien

https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv

Le fichier utilise l'encodage Unicode UTF-8. Le caractère de séparation des champs est <tab> (tabulation).

Export RDF

Les données sont également disponibles au format RDF. annonce en français.

Lien

https://world.openbeautyfacts.org/data/en.openbeautyfacts.org.products.rdf

API JSON Live

L'API se comporte à 99% comme celle d'Open Food Facts, donc la majorité des SDKs devraient fonctionner en remplaçant l'adresse de destination par openbeautyfacts.org. Le code n'a pas été mis à jour depuis plus d'un an, ainsi de nombreuses APIs plus récentes telles que les Knowledge Panels (panneaux d'informations) ne sont pas encore disponibles.

Une API JSON est également disponible pour accéder aux données d'un produit. Cette API est notamment utilisée au sein des applications Open Beauty Facts Android et iPhone.

Nous améliorons les API avec le temps, mais nous veillons à préserver la compatibilité avec les versions antérieures. N'hésitez pas à nous contacter si vous souhaitez certaines améliorations pour faciliter vos usages.

L'URL pour lire les données d'un produit : https://world.openbeautyfacts.org/api/v2/product/[code barre].json

Exemple : https://world.openbeautyfacts.org/api/v2/product/3600550578041.json

• API V1- Ancienne documentation disponible sur le Wiki (Note importante : la page est divisée en sous-pages pour READ et WRITE).
• API V2 - Complète mais non conforme à OpenAPI - Elle contient des cas d'utilisation pour afficher un produit et permettre à vos utilisateurs d'ajouter les données nécessaires pour obtenir le Nutri-Score, la classification NOVA, les additifs et l'Eco-Score.
• API V2 - nouvelle documentation OpenAPI - Travail en cours
• API V3 - nouvelle documentation OpenAPI - Travail en cours

Vous avez parfaitement le droit d'utiliser l'API pour des programmes en production, tant qu'1 appel API = 1 scan par un utilisateur réel. Toute tentative de "scraper" la base de données en utilisant l'API sera très probablement bloquée, car des exports journaliers complets sont disponibles sur cette page.

En outre, l'envoi d'un en-tête HTTP avec votre appel d'API est un moyen efficace pour que l'on puisse vous contacter, en cas de problème.

Si vous avez un quelconque doute, ou avez une question (il n'y a pas de question bête !), sentez-vous libre de nous demander sur Slack :-)

Application mobile Android et iPhone (aide nécessaire !)

Le code de l'application mobile Open Beauty Facts est disponible sur GitHub (Android et iOS). Nous avons besoin d'aide pour adapter le nouveau code natif iOS aux cosmétiques L'application permet aux utilisateurs de scanner le code barre d'un produit, consulter ses informations et de prendre et envoyer des photos et données pour les produits manquants.

L'application Android est développée en Kotlin.

La nouvelle application mobile multiplateforme est développée en Flutter/Dart.

Vous êtes invités à réutiliser le code (il est open source) et à nous aider à l'améliorer, pour tous, sur toute la planète.

Wrappers et SDKs

Nous avons probablement un wrapper pour votre langage de programmation préféré. Si c'est le cas, vous pouvez l'utiliser et l'améliorer, ainsi que probablement ajouter la compatibilité à Open Beauty Facts. Sinon, vous pouvez aider à le créer. Sinon, vous pouvez aider à le créer.

Ils vous permettront de consommer des données et permettront à vos utilisateurs de créer de nouvelles données.

• Cordova : GitHub (ancienne application officielle Open Beauty Facts)
• DART : GitHub (Open Food Facts uniquement pour l'instant)
• Elixir : GitHub (Open Food Facts uniquement pour l'instant)
• Go : GitHub (Open Food Facts uniquement pour l'instant)
• NodeJS : GitHub (Open Food Facts uniquement pour l'instant)
• PHP : GitHub (Open Food Facts uniquement pour l'instant)
• PHP (Lararel) : GitHub (Open Food Facts uniquement pour l'instant)
• Python : GitHub (Open Food Facts uniquement pour l'instant)
• React Native : GitHub (Open Food Facts uniquement pour l'instant)
• Ruby : GitHub (compatible Open Beauty Facts)

Discuter des données, de l'API et des exports

Vous pouvez rejoindre le canal de discussion Slack Open Beauty Facts qui est la meilleure façon de discuter et de poser des questions à propos de l'API.

Vous pouvez ouvrir un fil de discussion sur notre dépôt de documentation API

Contact

Pour toute question sur les données, vous pouvez nous contacter à l'adresse email contact@openfoodfacts.org