Pomozte nám, aby se transparentnost potravin stala normou!

Jako nezisková organizace jsme závislí na vašich darech, abychom i nadále mohli informovat spotřebitele po celém světě o tom, co jedí.

Potravinová revoluce začíná u vás!

Podpořit
close

Ú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

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