Gıda şeffaflığını bir norm haline getirmemize yardımcı olun!

Kâr amacı gütmeyen bir kuruluş olarak, dünyanın dört bir yanındaki tüketicileri ne yedikleri konusunda bilgilendirmeye devam etmek için bağışlarınıza güveniyoruz.

Gıda devrimi sizinle başlıyor!

Bağış Yapın

Veri

Yeniden kullanım koşulları

Open Food Facts veritabanı Açık Veritabanı Lisansı altında kullanılabilir.
Veritabanındaki her bir içerik Veritabanı İçerikleri Lisansı altında kullanılabilir.
Ürün fotoğrafları Creative Commons Attribution ShareAlike lisansı altında kullanılabilir. Bazı durumlarda çoğaltılabilen (alıntı hakkı veya adil kullanım), telif haklarına veya diğer haklara tabi grafiksel ögeler içerebilirler.

Lütfen verileri tekrar kullanmadan önce Kullanım şartlarını ve yeniden kullanım koşullarını okuyunuz.

Bize yeniden kullanımınızdan bahsedin

Open Food Facts verilerinin ne için kullanıldığını öğrenmeye çok meraklıyız. Zorunlu değildir ancak Open Food Facts topluluğuyla paylaşabilmemiz için yeniden kullanımlarınız hakkında bize bilgi verirseniz çok memnun oluruz. Uygulamanızın öne çıkarılması şansını yakalamak için bu formu da doldurabilirsiniz.

Open Food Facts veri dışa aktarımları

Veritabanı dökümleri ve dışa aktarımları her gece yapılır. Veritabanı çok büyük olduğundan, dışa aktarma biçimine bağlı olarak verileri kullanmanın farklı yollarını bulabilirsiniz.

MongoDB dökümü ve CSV dışa aktarımına ilişkin farklı alanlara ilişkin bilgiler https://tr.openfoodfacts.org/data/data-fields.txt adresinde bulunabilir

MongoDB dökümü

Tüm ürünler için veriler MongoDB veritabanı dökümünde mevcuttur.

Link
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 Dışa Aktarım

Günlük delta dışa aktarımlar önceki 14 gün için sağlanmaktadır. Şu anda mevcut olan delta dosyalarının listesi https://static.openfoodfacts.org/data/delta/index.txt adresinde bulunabilir.

Her satır https://static.openfoodfacts.org/data/delta/{filename} adresinde mevcut bir dosyaya karşılık gelmektedir.

Dosya adı, JSON dosyasındaki ilk ve son değişikliğin UNIX zaman damgasını içerir; böylece delta dosyaları mongoimport ile alfabetik sırayla içe aktarılabilir (çıkarıldıktan sonra).

Lütfen mongoexport'un yapısı gereği, delta dosyalarının silinen ürünler hakkında size bilgi veremeyeceğini unutmayın. Silinen ürünleri veritabanınızdan kaldırmak için MongoDB dökümünün tamamını içe aktarmanız gerekecektir.

CSV Veri Dışa Aktarımı

Veritabanının tamamı ayrıca her satırın bir JSON nesnesi olduğu JSONL format (bazen LDJSON veya NDJSON olarak da adlandırılır) mevcuttur. MongoDB dışa aktarımıyla aynı verileri temsil eder. Dosya gzip ile sıkıştırılmıştır.

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

Veritabanından yararlanmanın uygun bir yolu, büyük miktarda veriyi saniyeler içinde işlemek için tasarlanmış bir süreç içi analitik araç olan DuckDB'yi kullanmaktır. You can read our blog post where we walk you through exploring and processing the Open Food Facts database with DuckDB

CSV Veri Dışa Aktarımı

Tüm ürünlere veya bazı ürünlere ilişkin veriler, gelişmiş arama formu aracılığıyla CSV formatında (LibreOffice, Excel ve diğer birçok e-tablo yazılımıyla okunabilir) indirilebilir.

Bağlantılar
https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (GZIP formatında sıkıştırılmış CSV: ~ 0,9 Gb, sıkıştırılmamış: ~ 9 Gb)

Dosya kodlaması Unicode UTF-8'dir. Alanları ayıran karakter <tab> (tablolama)'dır.

RDF Veri Dışa Aktarımı

Veritabanı RDF formatında da mevcuttur. Fransızca duyuruyu okuyabilirsiniz.

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

Görüntü Verilerini Dışa Aktarma

Tüm görüntüler ve OCR sonuçları sunucumuzdan veya AWS'den (AWS Açık Veri Programı aracılığıyla) indirilebilir. Resimlerin nasıl indirileceği hakkında daha fazla bilgi edinmek için belgelerimize göz atın.

Canlı JSON ve XML API'si

Bir ürünün verilerini okumak için bir JSON API de mevcuttur. Bu API özellikle iPhone ve Android için Open Food Facts mobil uygulamalarında kullanılır.

API'yi zamanla geliştiriyoruz ancak geriye dönük uyumluluğu korumaya özen gösteriyoruz. Kullanıyorsanız lütfen iletişime geçin. Böylece size olası değişiklikler hakkında bilgi verebiliriz.

Bir ürüne ilişkin verileri okumak için URL: https://world.openfoodfacts.org/api/v2/product/[barcode].json

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

Çıktı çok yoğunsa API belgelerinde açıklandığı gibi filtreleyebileceğinizi unutmayın.

OpenAPI yardımı aranıyor

API belgelerini tamamlamayı, kullanım senaryolarını eklemeyi ve SDK oluşturmayı otomatikleştirmeyi sabırsızlıkla bekliyoruz. Eğer bir OpenAPI uzmanıysanız, yardım etmekten memnuniyet duyarız.

1 API çağrısı = kullanıcı tarafından yapılan 1 gerçek tarama olduğu sürece API'yi üretim amaçlarıyla kullanmanızdan memnuniyet duyarız. Tüm günlük dışa aktarımlar bu sayfada mevcuttur, dolayısıyla API kullanarak veritabanını baştan sona tarama girişimleri büyük ihtimalle engellenecektir.

Herhangi bir şey hakkında emin değilseniz, ya da herhangi bir sorunuz varsa (saçma soru diye bir şey yoktur), Slack kanalımızda sormaktan çekinmeyin :-)

Herhangi bir konuda emin değilseniz veya herhangi bir sorunuz varsa (aptalca soru diye bir şey yoktur), Slack'teki #api kanalında sormaya çekinmeyin :-)

Deneysel XML API'si

Sonucu .xmlkullanarak XML'de de alabilirsiniz.

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

Bu API aktif olarak korunmaz ve resmi olarak belgelenmez.

Wrapper'lar ve SDK'lar

Muhtemelen en sevdiğiniz programlama dili için bir wrapper'ımız vardır. Eğer varsa, onu kullanabilir ve iyileştirebilirsiniz. Eğer yoksa, oluşturmamıza yardımcı olabilirsiniz.

Soru sormak ve API'yi tartışmak için tercih edilen yol olan Open Food Facts Slack sohbet odasına katılabilirsiniz.

Kullanıcılarınızı mutlu edecek genel prensipler

  • Birçok faydalı hesaplanmış değer de dahil olmak üzere ürünler hakkında bilgi arayabilirsiniz.
  • DART: GitHub
  • Ayrıca, kendi taraflarında biraz çaba harcayarak sonucu hemen almaları için tam akışı da uygulayabilirsiniz.

Kullanıcılarınız hemen bir sonuç beklemiyorsa (örn. Envanter uygulamaları)

  • Fotoğrafları gönderin (ön yüz/besin değerleri/içindekiler): Kullanıcılar anlayabileceği en basit haliyle
  • Open Food Facts AI - Robotoff - fotoğraflardan bazı türetilmiş veriler üretecek
  • Zamanla diğer uygulamalar ve Open Food Facts topluluğu veri boşluklarını dolduracak

Kullanıcılarınız hemen bir sonuç bekliyorsa (ör. Beslenme uygulamaları)

  • Beslenme gerçeklerini gönderin + kategori > Nutri-Score'u alın
  • Malzemeleri gönder > NOVA grubunu (gıda ultra işleme hakkında), katkı maddelerini, alerjenleri, normalleştirilmiş içerik maddelerini, vegan, vejetaryen… edinin
  • Kategori + etiketleri gönderin > yakında Eco-Score'u alın (çevresel etki hakkında)

Android ve iPhone mobil uygulaması

Open Food Facts mobil uygulamasının kodu GitHub'da mevcuttur (Flutter, Kotlin Android ve Swift iOS).

Kullanımdan kaldırılan Kotlin ve Swift kod tabanlarını Kotlin ve Swift SDK'larına dönüştürmeye çalışıyoruz. Uygulama, kullanıcıların ürünlerin barkodunu taramasına, ürün bilgilerini görüntülemesine ve eksik ürünler için fotoğraf ve veri çekip göndermesine olanak tanır.

Uygulama, kullanıcıların ürünlerin barkodunu taramasına, ürün bilgilerini görüntülemesine ve eksik ürünler için resim ve veri çekip göndermesine olanak tanır.

Kodu (açık kaynaktır) yeniden kullanmaya ve gezegen üzerindeki herkes için iyileştirmemize yardımcı olabilirsiniz.

SDK'lar

Verileri, API'yi ve dışa aktarımları tartışmak

API ve Veri Dışa Aktarma işlemleriyle ilgili yaygın sıkça sorulan sorulara ve Open Food Facts'le ilgili yaygın sorulara bakabilirsiniz.

Soru sormanın ve API'yi tartışmanın tercih edilen yolu olan Open Beauty Facts Slack sohbet odasına katılın. Lütfen sorularınızı #api kanalında sorun

https://github.com/openfoodfacts/api-documentation/discussions

Verilerle ilgili herhangi bir sorunuz varsa reuse@openfoodfacts.org adresinden bizimle iletişime geçebilirsiniz.