Pomozte nám informovat miliony spotřebitelů po celém světě o tom, co jedí

group photo donation 2024
open food facts logo

Please give to our 2024 Fundraiser

Vaše dary financují každodenní provoz našeho neziskového sdružení:

  • udržovat naši databázi otevřenou a přístupnou všem,
    • technická infrastruktura (web/mobilní aplikace) a malý stálý tým
  • zůstat nezávislí na potravinářském průmyslu,

  • zapojit komunitu angažovaných občanů,

  • podporovat pokrok ve výzkumu veřejného zdraví.

Každý dar se počítá! Vážíme si vaší podpory při zavádění další transparentnosti potravin ve světě.

Údaje

Podmínky pro opětovné použití

Databáze Open Food Facts je k dispozici pod Open Database License.
Jednotlivý obsah databáze je k dispozici pod licencí k obsahu databáze.
Obrázky produktů jsou k dispozici pod licencí Creative Commons Uveďte autora ShareAlike. Mohou obsahovat grafické prvky podléhající autorským právům nebo jiným právům, které mohou být v některých případech reprodukovány (práva na nabídky nebo fair use).

Před opětovným použitím dat si prosím přečtěte Podmínky používání a opětovného použití.

Řekněte nám o svém opětovném použití

Velmi nás zajímá zjištění, k čemu se používají data Open Food Facts. To není povinné, ale velmi bychom ocenili, kdybyste nám řekli o svém opětovném použití, abychom ho mohli sdílet s komunitou Open Food Facts. Můžete také vyplnit tento formulář a získat tak šanci, aby byla vaše aplikace doporučena.

Export dat Open Food Facts

Výpisy a exporty databáze se generují každou noc. Databáze je velmi velká, takže můžete najít různé způsoby, jak použít datav závislosti na variantě exportu.

Informace o různých polích pro výpis MongoDB a exporty CSV jsou k dispozici na adrese https://world.openfoodfacts.org/data/data-fields.txt

Výpis MongoDB

Data pro všechny produkty jsou k dispozici ve výpisu databáze MongoDB.

Odkaz
https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz
sha256sum
https://static.openfoodfacts.org/data/gz-sha256sum
md5sum
https://static.openfoodfacts.org/data/gz-md5sum

Delta Export

Denní delta exporty jsou poskytovány za předchozích 14 dní. Seznam aktuálně dostupných delta souborů lze nalézt na https://static.openfoodfacts.org/data/delta/index.txt.

Každý řádek představuje soubor, který je dostupný na adrese https://static.openfoodfacts.org/data/delta/{filename}.

Název souboru obsahuje UNIX časové razítko prvního a poslední změny obsažené v souboru JSON, aby delta soubory mohly být importovány (po extrakci) pomocí mongoimport v abecedním pořadí.

Vezměte prosím na vědomí, že vzhledem k povaze mongoexportvám delta soubory nemohou říci o smazaných produktech. Chcete-li odebrat odstraněné produkty z databáze, musíte importovat celý výpis MongoDB.

Export dat JSONL

Celá databáze je k dispozici také ve formátu JSONL (někdy nazývaném LDJSON nebo NDJSON), kde je každý řádek objektem JSON. Představuje stejná data jako export MongoDB. Soubor je komprimován pomocí gzip.

Odkaz
https://static.openfoodfacts.org/data/openfoodfacts-products.jsonl.gz

A suitable way to exploit the database is to use DuckDB, an in-process analytical tool designed to process large amount of data in a fraction of seconds. You can read our blog post where we walk you through exploring and processing the Open Food Facts database with DuckDB

Export dat CSV

Data pro všechny produkty nebo některé produkty lze stáhnout ve formátu CSV (čitelný pomocí LibreOffice, Excel a mnoha dalších tabulkových softwarů) prostřednictvím formuláře pro pokročilé vyhledávání.

Odkazy
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (komprimovaný CSV ve formátu GZIP: ~ 0.9 Gb, rozbalený: ~ 9 Gb)

Kódování souboru je Unicode UTF-8. Znak, který odděluje pole, je <tab> (tabulka).

Export dat RDF

Databáze je dostupná také ve formátu RDF. Můžete si přečíst oznámení ve francouzštině.

Odkaz
https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf.gz

Export obrazových dat

Všechny obrázky a výsledky OCR lze stáhnout z našeho serveru nebo z AWS (prostřednictvím AWS Open Data Program). Podívejte se na naši dokumentaci a zjistěte více o tom, jak stahovat obrázky.

Dokumentace OpenAPI pro JSON API

K dispozici je také JSON API pro čtení dat pro produkt. Toto API se používá zejména v mobilní aplikaci Open Food Facts pro iPhone a Android.

API v průběhu času vylepšujeme, ale dbáme na zachování zpětné kompatibility. Prosím, kontaktujte nás, pokud ho používáte, abychom Vás mohli informovat o možných změnách.

Adresa URL pro čtení dat o produktu: https://world.openfoodfacts.org/api/v2/product/[barcode].json

Příklad: https://world.openfoodfacts.org/api/v3/product/737628064502.json

Všimněte si, že pokud je výstup příliš zahlcující, můžete jej filtrovat – jak je popsáno v dokumentaci API.

Hledáme pomoc s OpenAPI

Jsme dychtiví dokončit dokumentaci API, přidat případy použití a automatizovat generování SDK. Pokud jste znalci OpenAPI, rádi si necháme pomoct.

Je velmi vítáno používat API pro produkční případy, pokud 1 volání API = 1 skutečné skenování uživatelem. Jakýkoli pokus o stažení databáze pomocí API bude velmi pravděpodobně zablokován, protože právě na této stránce jsou k dispozici úplné denní exporty.

Také odeslání HTTP hlavičky s vaším voláním API je dobrý způsob, jak se s námi spojit, pokud by nastal nějaký problém.

Pokud si nejste jistí, nebo máte nějaké dotazy (není tu žádná pošetilá otázka), Neváhejte se zeptat na kanálu #api na Slack :-)

Experimentální XML API

Výsledek můžete také získat v XML pomocí .xml

Příklad: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

Toto API není aktivně udržováno a není oficiálně zdokumentováno.

Obaly a sady SDK

Pravděpodobně máme wrapper pro váš oblíbený programovací jazyk. Pokud ano, můžete to využít a vylepšit. Pokud ne, můžete pomoci s jeho vytvořením.

Umožní vám spotřebovávat data a také umožní vašim uživatelům přispívat novými daty

Obecné zásady, aby byli vaši uživatelé spokojeni

  • Můžete vyhledávat informace o produktech, včetně mnoha užitečných vypočtených hodnot.
  • Pokud nemůžete získat informace o konkrétním produktu, můžete přimět uživatele, aby poslal fotografie a data, která pak zpracuje Open Food Facts AI a přispěvatelé, aby získali vypočítaný výsledek, který jim chcete ukázat.
  • Můžete také implementovat kompletní tok tak, aby okamžitě získali výsledek s určitým úsilím na jejich straně.

Pokud vaši uživatelé neočekávají výsledek okamžitě (např. aplikace Inventory)

  • Odešlete fotografie (přední strana/výživa/ingredience): pro vaše uživatele naprosto bezbolestná věc
  • Open Food Facts AI „Robotoff“ vygeneruje některá odvozená data z fotografií
  • Časem mezery v datech zaplní další aplikace a komunita Open Food Facts

Pokud vaši uživatelé očekávají výsledek okamžitě (např. aplikace pro výživu)

  • Odešlete nutriční fakta + kategorie > získejte Nutri-Score
  • Odešlete ingredience > získejte skupinu NOVA (o ultrazpracování potravin), přísady, alergeny, normalizované ingredience, veganské, vegetariánské…
  • Odešlete kategorii + štítky > brzy získáte Eco-Score (o dopadu na životní prostředí)

Mobilní aplikace pro Android/iPhone/Flutter

Kódy pro oficiální mobilní aplikace Open Food Facts jsou dostupné na GitHubu: Flutter, Kotlin Android a Swift iOS

Uvažujeme o přeměně zastaralých kódových základen Kotlinu a Swiftu na SDK Kotlinu a Swiftu, pomoc vítána :-)

Aplikace umožňuje uživatelům naskenovat čárový kód produktů, zobrazit informace o produktu a pořídit a odeslat obrázky a data pro chybějící produkty.

Můžete znovu použít kód (je to open source) a pomoci nám jej vylepšit, pro každého na celé planetě.

SDK

Diskuse o datech, API a exportu

Můžete se podívat na nejčastější dotazy týkající se API a exportů dat a běžné otázky týkající se Open Food Facts

Můžete se připojit k Slackové chatovací místnosti Open Food Facts, což je preferovaný způsob, jak klást otázky a diskutovat o API. Prosím položte své otázky v kanálu #api

Můžete otevřít vlákno v našem úložišti dokumentace API

V případě jakýchkoli dotazů ohledně údajů nás můžete kontaktovat na reuse@openfoodfacts.org