Tiedot

Open Food Facts -tietokanta on Open Database License -lisenssin alaisuudessa.
Tietokannan yksilöllinen sisältö on Database Contents License -lisenssin alaisuudessa.
Tuotekuvat ovat Creative Commons Attribution ShareAlike licence -lisenssin alaisuudessa. Ne saattavat sisältää tekijänoikeuden tai muun oikeuden alaisia graafisia elementtejä, jotka joissain tapauksissa saa kopioida (lainausoikeudet tai kohtuullinen käyttö).

Lue Käytön ja uudelleenkäytön ehdot ja edellytykset ennen kuin uudelleen käytät tietoja.

Olemme erittäin kiinnostuneita oppimaan mihin Open Food Facts -tietoja käytetään. Se ei ole välttämätöntä, mutta arvostaisimme erittäin paljon, jos kertoisit meille uudelleenkäytöistäsi, jotta voimme jakaa ne Open Food Facts -yhteisölle.

Open Food Facts -tietojen viennit

Tietokantavedokset ja -viennit luodaan öisin. The database is very big, so you can find different ways to use the data, depending on the export flavor.

Tietoa MongoDB-vedoksen ja CSV-vientien eri kentistä on saatavilla osoitteesta https://world.openfoodfacts.org/data/data-fields.txt

MongoDB-vedos

Kaikkien tuotteiden tiedot ovat saatavilla MongoDB tietokantavedoksena.

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

Muutosten vienti

Päivittäiset muutosten viennit ovat saatavilla viimeiseltä 14:ltä päivältä. Luettelo tällä hetkellä saatavilla olevista muutostiedostoista löytyy osoitteesta https://static.openfoodfacts.org/data/delta/index.txt. Jokainen rivi vastaa tiedostoa, joka on saatavilla osoitteesta https://static.openfoodfacts.org/data/delta/{tiedostonnimi}. Tiedostonnimi sisältää UNIX-aikaleiman ensimmäisestä ja viimeisestä muutoksesta, jotka sisältyvät JSON-tiedostoon, jotta muutostiedostot voidaan tuoda (purkamisen jälkeen) aakkosjärjestyksessä komennolla mongoimport.

Huomioi, että mongoexport-komennon luonteen takia muutostiedostot eivät voi kertoa poistetuista tuotteista. Poistaaksesi poistetut tuotteet tietokannastasi sinun täytyy tuoda täysi MongoDB-vedos.

Tietojen CSV-vienti

The whole database is also available in JSONL format (sometimes called LDJSON or NDJSON) where each line is a JSON object. It represents the same data as the MongoDB export. The file is compressed with gzip.

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

Tietojen RDF-vienti

Tiedot kaikille tuotteille tai osalle tuotteista voi ladata CSV-muodossa (luettavissa OpenOfficella, Excelillä ja monella muulla ohjelmistolla) tarkennetun haun lomakkeella.

Linkki
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv

Tiedoston merkistökoodaus on Unicode UTF-8. Kenttien erottimena on <sarkain>.

Tietojen RDF-vienti

Tietokanta on myös saatavilla RDF-muodossa. ilmoitus ranskaksi.

Linkki
https://world.openfoodfacts.org/data/en.openfoodfacts.org.products.rdf

Live JSON API

Myös JSON API on saatavilla tuotteen tietojen lukemiseen. Tämä API on erityisesti käytössä Open Food Facts mobiilisovelluksessa iPhonelle ja Androidille.

We improve the API over-time but we are careful to keep backwards compatibility. Kerro meille, jos käytät sitä, jotta voimme kertoa sinulle mahdollisista muutoksista.

Esimerkki: https://world.openfoodfacts.org/api/v0/product/737628064502.json

Esimerkki: https://world.openfoodfacts.org/api/v0/product/737628064502.json

Further documentation is available here. It contains uses cases for displaying a product, and letting your users add the data required to get the Nutri-Score, the NOVA classification, additives, and the Eco-Score.

Voit käyttää API:a tuotannossa, kunhan 1 API-kutsu = 1 oikea viivakoodin lukeminen käyttäjältä. Kaikki yritykset kaapia tietokantaa API:a käyttämällä estetään erittäin todennäköisesti, sillä päivittäiset viennit ovat saatavilla tältä samaiselta sivulta.

Jos olet epävarma jostakin, tai sinulla on kysymyksiä (hölmöjä kysymyksiä ei ole), voit esittää kysymyksesi Slackissä :-)

If you are unsure about anything, or have any question (there is no silly question), feel free to ask it on the #api channel on Slack :-)

Android ja IPhone mobiilisovellukset

Koodi Open Food Facts -mobiilisovellukselle on saatavilla GitHubista (Android ja iOS). The app allows users to scan the barcode of products, to view the product information, and to take and submit pictures and data for missing products.

Android-sovellus on kehitetty Java-kielellä.

The app for Android is developed in Kotlin.

We also have an on-going Dart/Flutter effort.

Voit uudelleen käyttää koodia (se on avointa lähdekoodia), ja auttaa meitä parantamaan sitä, kaikille, koko planeetalla.

Kääreet ja SDK

Meillä on todennäköisesti kääre lempiohjelmointikielellesi. Jos on, voit käyttää ja parantaa sitä. Jos ei ole, voit auttaa luomaan sen.

Voit liittyä Open Food Facts Slack -keskusteluryhmään, joka on ensisijainen tapa kysyä kysymyksiä ja keskustella API:sta.

General principles

  • You can search for information about products, including many useful computed values.
  • If you can't get the information on a specific product, you can get your user to send photos and data, that will then be processed by Open Food Facts AI and contributors to get the computed result you want to show them.
  • You can also implement the complete flow so that they get immediately the result with some effort on their side.

If your users do not expect a result immediately (e.g. Inventory apps)

  • Submit photos (front/nutrition/ingredients): most painless thing for your users
  • The Open Food Facts AI Robotoff will generate some derived data from the photos
  • Over time, other apps, and the Open Food Facts community will fill the data gaps

If your users expect a result immediately (e.g. Nutrition apps)

  • Submit nutrition facts + category > get Nutri-Score
  • Submit ingredients > get the NOVA group (about food ultra-processing), additives, allergens, normalized ingredients, vegan, vegetarian…
  • Submit category + labels > soon get the Eco-Score (about environmental impact)

Keskustelu tiedoista, API:sta ja vienneistä

Voit liittyä Open Food Facts Slack -keskusteluryhmään, joka on ensisijainen tapa kysyä kysymyksiä ja keskustella API:sta.

Voit myös liittyä postituslistalle keskustellaksesi API:sta ja vienneistä, kertoaksesi meille uudelleenkäytöistäsi, ja saadaksesi ilmoituksen parannuksista tai muutoksista API:in. Lähetä tyhjä sähköposti osoitteeseen api-subscribe@openfoodfacts.org liittyäksesi.

Yhteystiedot

Tietoihin liittyvissä kysymyksissä voit ottaa meihin yhteyttä sähköpostilla osoitteeseen contact@openfoodfacts.org