Daten
Die Open Beauty Facts Datenbank ist unter der Open Database License.
verfügbar. Die einzelnen Inhalte der Datenbank sind unter der Database Contents License verfügbar.
Die Produktbilder sind unter der Creative Commons Attribution ShareAlike Lizenz verfügbar.
Sie könnten grafische Elemente enthalten, die dem Urheberrecht oder anderen Rechten unterliegen, die in einigen Fällen vervielfältigt werden können (Zitierrechte oder Fair Use).
Bitte lesen Sie die Nutzungs- und Weiterverwendungsbedingungen, bevor Sie die Daten weiterverwenden.
Wir sind sehr daran interessiert, zu erfahren, wofür die Open Beauty Facts-Daten verwendet werden. Es ist nicht verpflichtend, aber wir würden es sehr begrüßen, wenn Sie uns über Ihre Wiederverwendung informieren, damit wir sie mit der Open Beauty Facts-Gemeinschaft teilen können.
Open Beauty Facts Datenexporte
Datenbank-Abbildungen und -Exporte werden nächtlich generiert.
Informationen über die verschiedenen Felder für den MongoDB-Dump und den CSV-Export finden Sie unter https://world.openbeautyfacts.org/data/data-fields.txt
MongoDB-Datenbankauszug
Die Daten für alle Produkte sind in einem MongoDB-Datenbankdump verfügbar.
- Herunterladen
- https://static.openbeautyfacts.org/data/openbeautyfacts-mongodbdump.tar.gz
- SHA-256-Prüfsummen
- https://static.openbeautyfacts.org/data/sha256sum
- MD5-Prüfsummen
- https://static.openbeautyfacts.org/data/md5sum
Delta-Export
Tägliche Delta-Exporte werden für die letzten 14 Tage bereitgestellt. Die Liste der derzeit verfügbaren Delta-Dateien ist zu finden unter
https://static.openbeautyfacts.org/data/delta/index.txt.
Jede Zeile steht für eine Datei, die unter https://static.openbeautyfacts.org/data/delta/{filename}
verfügbar ist.
Der Dateiname enthält den UNIX-Zeitstempel der ersten und letzten in der JSON-Datei enthaltenen Änderung, so dass die Delta-Dateien (nach der Ausleitung) mit mongoimport
in alphabetischer Reihenfolge importiert werden können.
Bitte beachten Sie, dass die Delta-Dateien aufgrund der Natur von mongoexport
nicht über gelöschte Produkte informieren können. Bitte beachten Sie, dass die Delta-Dateien aufgrund der Natur von mongoexport
nicht über gelöschte Produkte informieren können.
CSV-Daten-Export
Die Daten für alle oder einen Teil der Produkte können im CSV-Format (lesbar mit OpenOffice, Excel und vielen anderen Programmen) über das Formular Erweiterte Suche heruntergeladen werden.
Als Dateikodierung wird Unicode UTF-8 verwendet. Als Trennzeichen für die Felder wird <tab> (Tabellierung) verwendet.
RDF-Daten-Export
Die Datenbank ist außerdem im RDF-Format verfügbar. Ankündigung in französischer Sprache.
Live-JSON-API
Die API verhält sich zu 99% wie Open Food Facts, so dass viele der SDKs und Codes, die mit der Open Food Facts API interagieren, funktionieren sollten, indem sie einfach den Endpunkt von openfoodfacts.org in openbeautyfacts.org ändern. Der Code ist seit über einem Jahr nicht mehr aktualisiert worden, so dass viele der neueren APIs wie Knowledge Panels noch nicht verfügbar sind.Eine JSON-API ist ebenfalls verfügbar, um die Daten für ein Produkt auszulesen. Diese API wird insbesondere in der mobilen App Open Beauty Facts für iPhone und Android verwendet.
Wir ändern die API über die Zeit, aber wir achten darauf, die Abwärtskompatibilität zu erhalten. Bitte teilen Sie uns mit, ob Sie sie verwenden, damit wir Sie über mögliche Änderungen informieren können.
URL zum Lesen der Daten für ein Produkt: https://world.openbeautyfacts.org/api/v2/product/[barcode].json
Beispiel: https://world.openbeautyfacts.org/api/v2/product/3600550578041.json
- API V1- Alte Dokumentation im Wiki verfügbar (Wichtiger Hinweis: Die Seite ist in Unterseiten für READ und WRITE unterteilt).
- API V2 - Umfassend, aber nicht OpenAPI-konform - Es enthält Anwendungsfälle für die Anzeige eines Produkts und die Möglichkeit für Ihre Benutzer, die erforderlichen Daten hinzuzufügen, um den Nutri-Score, die NOVA-Klassifizierung, Zusatzstoffe und den Eco-Score zu erhalten.
- API V2 - neue OpenAPI-Dokumentation (In Vorbereitung)
- API V3 - neue OpenAPI-Dokumentation (In Vorbereitung)
Sie können die API gerne für Produktionsabläufe verwenden, sofern 1 API-Aufruf = 1 realer Scan durch einen Benutzer entspricht. Jeder Versuch, die Datenbank auf diese Weise abzuschöpfen, wird sehr wahrscheinlich verhindert, da vollständige tägliche Exporte auf dieser Seite verfügbar sind.
Auch das Senden eines HTTP-Headers mit Ihrem API-Aufruf ist eine gute Möglichkeit, mit uns in Kontakt zu treten, falls irgendwelche Probleme auftreten sollten.
Wenn Sie sich bei irgendetwas unsicher sind oder eine Frage haben (es gibt keine dumme Frage), zögern Sie nicht, diese auf der Plattform Slack zu stellen 🙂
Mobile App für Android und iPhone (Hilfe benötigt!)
Der Quellcode für die mobile App von Open Beauty Facts ist auf GitHub verfügbar (Android und iOS). Wir benötigen Hilfe bei der Anpassung des neuen nativen iOS-Codes für Kosmetika Die App ermöglicht es den Nutzern, den Strichcode von Produkten einzulesen, die Produktinformationen einzusehen und Bilder und Daten für fehlende Produkte aufzunehmen und zu versenden.
Die App für Android wird in der Programmiersprache „Kotlin” entwickelt.
Die neue plattformübergreifende App wird in Flutter/Dart entwickelt.
Sie können den Quellcode (es ist Open Source) gerne wiederverwenden und uns helfen, ihn für alle auf der ganzen Welt zu verbessern.
Wrappers und SDKs
Wir haben wahrscheinlich einen Wrapper für Ihre bevorzugte Programmiersprache. Wenn wir das tun, können Sie es nutzen und verbessern und wahrscheinlich auch Open Beauty Facts unterstützen. Wenn wir es nicht tun, können Sie uns helfen, ihn zu erstellen.
Sie können dem Open Food Facts Chatroom auf Slack beitreten, der unser bevorzugter Weg ist, um Fragen zu stellen und die über die API zu diskutieren.
- Cordova: GitHub (alte offizielle App Open Beauty Facts)
- DART: GitHub (Derzeit nur Open Food Facts)
- Elixier: GitHub (Derzeit nur Open Food Facts)
- Go: GitHub (Derzeit nur Open Food Facts)
- NodeJS: GitHub (Derzeit nur Open Food Facts)
- PHP: GitHub (Derzeit nur Open Food Facts)
- PHP (Lararel): GitHub (Derzeit nur Open Food Facts)
- Python: GitHub (derzeit nur Open Food Facts)
- React Native: GitHub (derzeit nur Open Food Facts)
- Ruby: GitHub (Open Beauty Facts kompatibel)
Über Daten, API und Exportfunktionen diskutieren
Sie können ein Thema in unserem API-Dokumentations-Repository eröffnen
Kontakt
Wenn Sie Fragen zu den Daten haben, können Sie uns unter contact@openfoodfacts.org kontaktieren.