Auta meitä tekemään ruoan läpinäkyvyydestä normi!

Voittoa tavoittelemattomana järjestönä olemme riippuvaisia lahjoituksistanne jatkaaksemme kuluttajien valistamista siitä, mitä he syövät.

Ruoan vallankumous alkaa sinusta!

Lahjoita
close

Tiedot

Uudelleenkäytön ehdot

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.

Kerro meille uudelleenkäytöstäsi

Olemme erittäin kiinnostuneita oppimaan mihin Open Food Facts -tietoja käytetään. Se ei ole pakollista, mutta olisimme erittäin kiitollisia, jos kerrot meille uudelleenkäytöstäsi jotta voimme jakaa ne Open Food Facts -yhteisön kanssa. Voit myös täyttää tämän lomakkeen saadaksesi mahdollisuuden saada sovelluksesi esille.

Open Food Facts -tietojen viennit

Tietokantavedokset ja -viennit luodaan öisin. Tietokanta on erittäin suuri, joten voit löytää erilaisia tapoja käyttää tietojavientimausta riippuen.

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.gz
sha256sum
https://static.openfoodfacts.org/data/gz-sha256sum
md5sum
https://static.openfoodfacts.org/data/gz-md5sum

Muutosten vienti

Päivittäiset muutosten viennit ovat saatavilla viimeiseltä 14:ltä päivältä. Luettelo tällä hetkellä saatavilla olevista deltatiedostoista 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}.

Tiedostonimi sisältää JSON-tiedoston ensimmäisen ja viimeisen muutoksen UNIX-aikaleiman, jotta delta-tiedostot voidaan tuoda (purkauksen jälkeen) mongoimport :lla aakkosjärjestyksessä.

Huomioi, että mongoexport-komennon luonteen takia muutostiedostot eivät voi kertoa poistetuista tuotteista. Jos haluat poistaa poistetut tuotteet tietokannastasi, sinun on tuotava koko MongoDB-vedos.

Tietojen CSV-vienti

Koko tietokanta on saatavilla myös JSONL-muodossa (joskus kutsutaan nimellä LDJSON tai NDJSON), jossa jokainen rivi on JSON-objekti. Se edustaa samoja tietoja kuin MongoDB-vienti. Tiedosto on pakattu gzip:llä.

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

Tietojen CSV-vienti

Kaikkien tuotteiden tai joidenkin tuotteiden tiedot voidaan ladata CSV-muodossa (luettavissa LibreOfficella, Excelillä ja monilla muilla taulukkolaskentaohjelmilla) tarkennetun hakulomakkeenkautta.

Linkit
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (compressed CSV in GZIP format: ~ 0.9 Gb, uncompressed: ~ 9 Gb)

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

Tietojen RDF-vienti

Tietokanta on myös saatavilla RDF-muodossa. Voit lukea ilmoituksen ranskaksi.

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

Kuvatietojen vienti

Kaikki kuvat ja OCR-tulokset voidaan ladata joko palvelimeltamme tai AWS:stä (AWS Open Data Program -ohjelman kautta). Tutustu dokumentaatioomme saadaksesi lisätietoja miten ladata kuvia.

OpenAPI Documentation for the 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.

Parannamme ohjelmointirajapintaa ajan myötä, mutta huolehdimme yhteensopivuudesta aiempien versioiden kanssa. ota yhteyttä jos käytät sitä, jotta voimme kertoa sinulle mahdollisista muutoksista.

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

Example: https://world.openfoodfacts.org/api/v3/product/737628064502.json

Huomaa, että jos tulos on liian suuri, voit suodattaa sen API-dokumentaation mukaisesti.

OpenAPI-apua kaivataan

Haluamme saada valmiiksi API:n dokumentoinnin, lisätä käyttötapauksia ja automatisoida SDK:n luomisen. Jos olet OpenAPI-tuntija, olet erittäin tervetullut auttamaan.

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ä :-)

Jos olet epävarma jostakin, tai sinulla on jokin kysymys (ei ole typeriä kysymyksiä), kysy rohkeasti #api-kanavalla Slackissa :-)

Kokeellinen XML API

Tulokset saa myös XML-muodossa päätteellä .xml

Esimerkki: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

Tätä API:ta ei ylläpidetä aktiivisesti, eikä sitä ole dokumentoitu virallisesti.

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.

Yleiset periaatteet käyttäjien ilahduttamiseksi

  • Voit etsiä tietoja tuotteista, mukaan lukien monia hyödyllisiä laskettuja arvoja.
  • Jos et saa tietoja tietystä tuotteesta, voit pyytää käyttäjää lähettämään valokuvia ja tietoja, jotka sitten Open Food Facts AI ja avustajat käsittelevät saadakseen lasketun tuloksen, jonka haluat näyttää heille.
  • Voit myös toteuttaa koko flown niin, että he saavat heti tuloksen pienellä vaivalla.

Jos käyttäjäsi eivät odota tulosta heti (esim. varastosovellukset)

  • Lähetä valokuvat (etu/ravinto/ainesosat): käyttäjillesi kivuton asia
  • Open Food Facts AI - Robotoff - tuottaa valokuvista johdettuja tietoja
  • Ajan myötä muut sovellukset ja Open Food Facts -yhteisö täyttävät tietoaukot

Jos käyttäjäsi odottavat tulosta välittömästi (esim. ravitsemussovellukset)

  • Lähetä ravitsemustiedot + kategoria > saat Nutri-Scoren
  • Ilmoita ainesosat > hanki NOVA-ryhmä (ruoan ultraprosessoinnista), lisäaineet, allergeenit, normalisoidut ainesosat, vegaani, vegetaari…
  • Lähetä luokka + tunnisteet > saat pian Eco-Scoren (ympäristövaikutuksista)

Android/iPhone/Flutter mobile app

The code for the official Open Food Facts mobile apps is available on GitHub Flutter Kotlin Android Swift iOS

We look to turn the deprecated Kotlin and Swift codebases into Kotlin and Swift SDKs, help welcome :-)

Sovelluksen avulla käyttäjät voivat skannata tuotteiden viivakoodeja, katsella tuotetietoja, ja ottaa ja lähettää kuvia ja tietoja puuttuvista tuotteista.

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

SDK:t

Keskustelu tiedoista, API:sta ja vienneistä

Voit tarkastella yleisiä API:ta ja tietojen vientiä koskevia FAQ-kysymyksiä ja yleisiä Open Food Facts -kysymystä

Voit Open Food Facts Slack -keskusteluhuoneeseen, joka on suositeltu tapa esittää kysymyksiä ja keskustella API:sta. Ole hyvä esitä kysymyksesi #api kanavalla

Voit aloittaa viestiketjun ohjelmointirajapintadokumentaatiotietovarastossamme

Jos sinulla on kysyttävää datasta, voit ottaa meihin yhteyttä osoitteeseen reuse@openfoodfacts.org