معطيات

شروط إعادة الاستخدام

قاعدة بيانات Open Food Facts متاحة بموجب ترخيص قاعدة البيانات المفتوحة.
محتويات قاعدة البيانات الفردية متاحة بموجب ترخيص محتويات قاعدة البيانات.
صور المنتجات متاحة بموجب ترخيص المشاع الإبداعي النسب بالمثل. قد تحتوي على عناصر رسومية تخضع لحقوق الطبع والنشر أو حقوق أخرى، التي قد يتم إعادة إنتاجها في بعض الحالات (حقوق الاقتباس أو الاستخدام العادل).

يرجى قراءة شروط وأحكام الاستخدام وإعادة الاستخدام قبل إعادة استخدام البيانات.

أخبرنا عن إعادة استخدامك

نحن مهتمون جدًا بمعرفة كيفية استخدام بيانات Open Food Facts. ليس إلزاميًا، ولكننا نقدر ذلك كثيرًا إذا أخبرتنا عن إعادة استخداماتك حتى نتمكن من مشاركتها مع مجتمع Open Food Facts. يمكنك أيضًا ملء هذا النموذج للحصول على فرصة لعرض تطبيقك.

تصديرات بيانات Open Food Facts

يتم إنشاء تفريغات قاعدة البيانات والتصديرات كل ليلة. قاعدة البيانات كبيرة جدًا، لذا يمكنك العثور على طرق مختلفة لاستخدام البيانات، اعتمادًا على نوع التصدير.

معلومات حول الحقول المختلفة لتفريغ MongoDB وتصديرات CSV متوفرة على https://world.openfoodfacts.org/data/data-fields.txt

تفريغ MongoDB

البيانات الخاصة بجميع المنتجات متوفرة في تفريغ قاعدة بيانات MongoDB.

رابط

https://static.openfoodfacts.org/data/openfoodfacts-mongodbdump.gz

sha256sum

https://static.openfoodfacts.org/data/gz-sha256sum

md5sum

https://static.openfoodfacts.org/data/gz-md5sum

تصدير دلتا

يتم توفير تصديرات الدلتا اليومية للأيام الـ 14 السابقة. قائمة ملفات الدلتا المتوفرة حاليًا يمكن العثور عليها على https://static.openfoodfacts.org/data/delta/index.txt.

كل سطر يمثل ملفًا متوفرًا على https://static.openfoodfacts.org/data/delta/{filename}.

يحتوي اسم الملف على طابع زمني UNIX لأول وآخر تغيير موجود في ملف JSON، بحيث يمكن استيراد ملفات دلتا (بعد الاستخراج) باستخدام mongoimport بالترتيب الأبجدي.

يرجى ملاحظة أنه بسبب طبيعة mongoexport، لا يمكن لملفات الدلتا إخبارك عن المنتجات المحذوفة. لإزالة المنتجات المحذوفة من قاعدة بياناتك، ستحتاج إلى استيراد تفريغ MongoDB الكامل.

تصدير بيانات JSONL

قاعدة البيانات الكاملة متوفرة أيضًا بصيغة JSONL (التي تُسمى أحيانًا LDJSON أو NDJSON) حيث يكون كل سطر هو كائن JSON. يمثل نفس البيانات كما في تصدير MongoDB. الملف مضغوط باستخدام gzip.

رابط

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

طريقة مناسبة لاستغلال قاعدة البيانات هي استخدام DuckDB، وهو أداة تحليلية تعمل ضمن العملية مصممة لمعالجة كميات كبيرة من البيانات في جزء من الثانية. يمكنك قراءة مقال المدونة حيث نشرح لك كيفية استكشاف ومعالجة قاعدة بيانات Open Food Facts باستخدام DuckDB

تصدير بيانات Parquet على Hugging Face

إصدار مبسط من تفريغ الـJSONL أيضاً في تنسيق الباركيه. خلال التحويل, صَفَّيّنا الأعمدة التي تحتوي على معلومات متكررة, تستخدم لتصحيح أخطاء داخلية, أو هي فقط عَرَضِيّة للمستخدمين.

لقد أثبت تنسيق الباركيه أنه مفيد:

• يتم تنظيم البيانات حسب العمود، وليس حسب الصف، مما يوفر مساحة التخزين ويسرع استعلامات التحليلات، أي أنه يمكنك تحديد الأعمدة التي تهمك فقط، مما يؤدي إلى تحسين أداء الاستعلامات، حتى على أجهزة الكمبيوتر الأساسية.
• ضغط البيانات وفك ضغطها بكفاءة عالية، مما يجعلها جيدة لتخزين ومشاركة مجموعات البيانات الكبيرة من أي نوع،
• يدعم أنواع البيانات المعقدة وهياكل البيانات المتداخلة المتقدمة.

تتوفر مجموعة البيانات على Hugging Face، وهو نظام بيئي تعاوني للتعلم الآلي حيث يمكن للمطورين والباحثين مشاركة النماذج ومجموعات البيانات.

رابط

https://huggingface.co/datasets/openfoodfacts/product-database/resolve/main/food.parquet?download=true

يمكنك العثور على مزيد من المعلومات في Wiki، بما في ذلك إرشادات إعادة استخدام البيانات وأمثلة الاستعلامات للبدء.

تصدير بيانات CSV

يمكن تنزيل بيانات جميع المنتجات، أو بعض المنتجات، بتنسيق CSV (قابل للقراءة باستخدام LibreOffice وExcel والعديد من برامج جداول البيانات الأخرى) من خلال نموذج البحث المتقدم .

الروابط

الطعام: https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (ملف CSV مضغوط بتنسيق GZIP: ~ 0.9 جيجابايت، غير مضغوط: ~ 9 جيجابايت)

مستحضرات التجميل: https://static.openbeautyfacts.org/data/en.openbeautyfacts.org.products.csv.gz

طعام الحيوانات الأليفة: https://static.openpetfoodfacts.org/data/en.openpetfoodfacts.org.products.csv.gz

كل المنتجات الاخرى:https://static.openproductsfacts.org/data/en.openproductsfacts.org.products.csv.gz

ترميز الملف هو Unicode UTF-8. الرمز الذي يفصل الحقول هو <tab> (الجدولة).

تصدير بيانات RDF

قاعدة بيانات هذه أيضاً متوفرة في صيغة RDF (هذه فقط تجربة, لم يعد يتم صيانته بشكل فعال). يمكنك قراءة الإعلان باللغة الفرنسية.

رابط

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

تصدير بيانات الصورة

يمكن تنزيل جميع الصور ونتائج التعرف الضوئي على الحروف (OCR) من خادمنا أو من AWS (من خلال برنامج AWS Open Data). قم بالاطلاع على وثائقنا لمعرفة المزيد حول كيفية تنزيل الصور

OpenAPI Documentation for the JSON API

تتوفر أيضًا واجهة برمجة تطبيقات JSON لقراءة البيانات الخاصة بمنتج ما. هذا الـAPI على وجه الخصوص مستخدم في تطبيق Open Food Facts للهواتف المحمولة.

نعمل على تحسين واجهة برمجة التطبيقات (API) بمرور الوقت ولكننا نحرص على الحفاظ على التوافق مع الإصدارات السابقة. يرجى التواصل معنا إذا كنت تستخدمه، حتى نتمكن من إخبارك بالتغييرات المحتملة.

اكتشف الـAPI الخاص بنا

المساهمة في تحسين وثائق الـAPI والـOpenAPI الخاصة بنا

نحن مشتاقين لإنهاء توثيق الـAPI, إضافة حالات الاستخدام, وأتمتة إنشاء الـSDK. إذا انت خبير في OpenAPI, فنرحب بك ترحيباً كثيرا لمساعدتنا.

مرحبًا بك كثيرًا لاستخدام الـAPI لحالات الإنتاج، طالما أن مكالمة API واحدة = مسح حقيقي واحد بواسطة مستخدم. أي محاولة لجمع قاعدة البيانات باستخدام واجهة برمجة التطبيقات ستُحظر على الأرجح، حيث تتوفر عمليات التصدير اليومية الكاملة في هذه الصفحة.

أيضًا ، إرسال رأس HTTP مع طلب API الخاص بك هو طريقة جيدة يمكننا من خلالها التواصل ، في حالة حدوث أي مشكلة.

واجهة برمجة تطبيقات XML (غير مدعومة)

يمكنك أيضًا الحصول على النتيجة بصيغة XML باستخدام .xml

مثال: https://world.openfoodfacts.org/api/v2/product/737628064502.xml

لا يتم صيانة هذه الواجهة البرمجية بشكل نشط، كما أنها غير موثقة رسميًا.

التغليفات ومجموعات تطوير البرامج

ربما لدينا غلافًا للغة البرمجة المفضلة لديك. إذا فعلنا ذلك، فيمكنك استخدامه وتحسينه. إذا لم نفعل ذلك، فيمكنك المساعدة في إنشائه.

سيسمحون لك باستهلاك البيانات، فضلاً عن السماح لمستخدميك بالمساهمة ببيانات جديدة

المبادئ العامة لإسعاد المستخدمين

• يمكنك البحث عن معلومات حول المنتجات، بما في ذلك العديد من القيم المحسوبة المفيدة.
• إذا لم تتمكن من الحصول على المعلومات حول منتج معين، فيمكنك جعل المستخدم يرسل الصور والبيانات، والتي سيتم معالجتها بعد ذلك بواسطة Open Food Facts AI والمساهمين للحصول على النتيجة المحسوبة التي تريد إظهارها لهم.
• يمكنك أيضًا تنفيذ التدفق الكامل حتى يحصلوا على النتيجة فورًا مع بذل بعض الجهد من جانبهم.

إذا لم يتوقع المستخدمون الحصول على نتيجة فورية (على سبيل المثال تطبيقات المخزون)

• إرسال الصور (الواجهة/التغذية/المكونات): الشيء الأكثر سهولة بالنسبة لمستخدميك
• سيقوم الذكاء الاصطناعي Open Food Facts - Robotoff - بإنشاء بعض البيانات المشتقة من الصور
• بمرور الوقت، ستعمل التطبيقات الأخرى ومجتمع Open Food Facts على سد فجوات البيانات

إذا كان المستخدمون يتوقعون الحصول على نتيجة على الفور (على سبيل المثال تطبيقات التغذية)

• أرسل معلومات التغذية + الفئة > احصل على Nutri-Score
• أرسل المكونات > احصل على مجموعة NOVA (حول المعالجة الفائقة للأطعمة)، المواد المضافة، المواد المسببة للحساسية، المكونات الطبيعية، نباتي، نباتي تمامًا…
• أرسل الفئة + العلامات > احصل قريبًا على النتيجة البيئية (حول التأثير البيئي)

Android/iPhone/Flutter mobile app

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

نسعى لتحويل قواعد بيانات Kotlin و Swift القديمة إلى حزم تطوير برمجية (SDKs) خاصة بـ Kotlin و Swift، ونرحب بالمساعدة :-)

يتيح التطبيق للمستخدمين مسح الرمز الشريطي للمنتجات، وعرض معلومات المنتج، والتقاط الصور والبيانات الخاصة بالمنتجات المفقودة وإرسالها.

نرحب بك لإعادة استخدام الكود (إنه مفتوح المصدر) ومساعدتنا في تحسينه، للجميع، في جميع أنحاء الكوكب.

حزم تطوير البرامج (SDK)

الرمز	لغة / إطار عمل	الموارد	المناقشة
	كوردوفا (التطبيق القديم)	GitHub	غير متوفر
	DART	GitHub pub.dev	غير متوفر
	Elixir	GitHub	قناة Slack
	Go	GitHub	قناة Slack
	Java	GitHub	قناة Slack
	Spring Boot	GitHub	قناة Slack
	Kotlin	GitHub	قناة Slack
	جافا سكريبت	GitHub	قناة Slack
	PHP	GitHub	قناة Slack
	PHP (Laravel)	GitHub	قناة Slack
	Python	GitHub	قناة Slack
	React Native	GitHub	قناة Slack
	Ruby	GitHub	قناة Slack
	الصدأ	GitHub	قناة Slack
	R	GitHub	قناة Slack
	Swift	GitHub	قناة Slack
	.NET/C#	GitHub	قناة Slack

مناقشة البيانات وواجهة برمجة التطبيقات والصادرات

يمكنك إلقاء نظرة على الأسئلة الشائعة الشائعة حول واجهة برمجة التطبيقات وتصدير البيانات و الأسئلة الشائعة حول Open Food Facts

يمكنك الانضمام إلى غرفة الدردشة الخاصة بـ Open Food Facts على Slack وهي الطريقة المفضلة لطرح الأسئلة ومناقشة واجهة برمجة التطبيقات. من فضلك اطرح أسئلتك في قناة #api

يمكنك فتح موضوع في مستودع وثائق واجهة برمجة التطبيقات الخاصة بنا

لأي سؤال بخصوص البيانات، يمكنك الاتصال بنا على reuse@openfoodfacts.org