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ä.
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.
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.
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
- Cordova: GitHub (vanha virallinen Open Food Facts -sovellus)
- DART: GitHub - Paketti osoitteessa pub.dev
- Elixir: GitHub - Keskustelukanava
- Go: GitHub - Keskustelukanava
- Java: GitHub - Keskustelukanava
- Kotlin: GitHub - Keskustelukanava
- NodeJS: GitHub - Keskustelukanava
- PHP: GitHub - Keskustelukanava
- PHP (Laravel): GitHub - Keskustelukanava
- Python: GitHub - Keskustelukanava
- React Native: GitHub - Keskustelukanava
- Ruby: GitHub - Keskustelukanava
- Rust: GitHub - Keskustelukanava
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