Veri
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.
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ı bize anlatırsanız çok memnun oluruz.
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.tar.gz
- sha256sum
- https://static.openfoodfacts.org/data/sha256sum
- md5sum
- https://static.openfoodfacts.org/data/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 delta dosyalarının listesi
https://static.openfoodfacts.org/data/delta/index.txt adresinde bulunmaktadır.
Her satır https://static.openfoodfacts.org/data/delta/{filename}
adresinde mevcut bir dosyaya karşılık gelmektedir.
Dosya adı, JSON dosyasında bulunan ilk ve son değişikliğin UNIX zaman damgasını içerir, böylece delta dosyaları mongoimport
ile alfabetik sıraya göre içe aktarılabilir (çıkarma işleminden 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 bütün MongoDB dökümünü içe aktarmanız gerekmektedir.
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.
CSV Veri Dışa Aktarımı
Tüm ürünlere veya bazı ürünlere ait veriler, gelişmiş arama formu aracılığıyla CSV formatında (OpenOffice, Excel ve diğer birçok yazılımla okunabilir) indirilebilir.
- Bağlantılar
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (ham CSV)
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (GZIP formatında sıkıştırılmış CSV)
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 duyuru.
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. Lütfen kullanıyorsanız iletişime geçin, olası değişiklikleri size bildirelim.
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/v2/product/737628064502.json
Sonucu .xml
kullanarak XML'de de alabilirsiniz.
Örnek: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
- API V1- Wiki'de bulunan eski belgeler (Önemli not: sayfa okuma ve yazma için alt sayfalara bölünmüştür).
- API V2 - Kapsamlı ancak OpenAPI uyumlu değil - Bir ürünü görüntülemek ve kullanıcılarınızın Nutri-Score, NOVA sınıflandırması, katkı maddeleri ve Eco-Score'u almak için gereken verileri eklemesine olanak tanıyan kullanım senaryoları içerir.
- API V2 - yeni OpenAPI belgeleri - Devam Eden Çalışmalar
- API V2 - yeni OpenAPI belgeleri - Devam Eden Çalışmalar
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 :-)
Android ve iPhone mobil uygulaması
Open Food Facts mobil uygulamasının kodu GitHub'da mevcuttur (Flutter, Android ve iOS). 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.
IOS için klasik uygulama Swift'te geliştirilmiştir.
Android için klasik uygulama Kotlin'de geliştirilmiştir.
Yeni çapraz platform uygulaması bir Dart/Flutter uygulamasıdır.
Kodu (açık kaynaktır) yeniden kullanmaya ve gezegen üzerindeki herkes için iyileştirmemize yardımcı olabilirsiniz.
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.
Genel ilkeler
- 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)
- Cordova: GitHub (eski Open Food Facts resmi uygulaması)
- PHP (Lararel): GitHub
- Elixir: GitHub
- Git: GitHub
- Java: GitHub
- Kotlin: GitHub
- NodeJS: GitHub
- PHP: GitHub
- PHP (Lararel): GitHub
- Python: GitHub
- React Native: GitHub
- Ruby: GitHub
- Rust: GitHub
Verileri, API'yi ve dışa aktarımları tartışmak
https://github.com/openfoodfacts/api-documentation/discussions
İletişim
Verilerle ilgili herhangi bir sorunuz varsa, contact@openfoodfacts.org adresinden bize ulaşabilirsiniz