נתונים
מסד הנתונים של Open Food Facts database זמין תחת רישיון מסדי נתונים פתוחים.
תכני מסד הנתונים לכשעצמם מוגנים תחת רישיון תוכן מסדי נתונים.
תמונות המוצרים זמינות תחת הרישיון Creative Commons Attribution ShareAlike.
כל אלו עשויים להכיל רכיבים גרפיים שכפופים לזכויות יוצרים או זכויות אחרות, שבמקרים אחרים מאפשרים יצירה מחדש (זכויות ציטוט או שימוש הוגן).
נא לקרוא את תנאי השימוש והגזירה לפני גזירת הנתונים.
אנו מאוד מעוניינים ללמוד למה משמשים אותך הנתונים של 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.tar.gz
- sha256sum
- https://static.openfoodfacts.org/data/sha256sum
- md5sum
- https://static.openfoodfacts.org/data/md5sum
ייצוא הבדלים
תוצרי ייצוא של הפרשים יומיים מסופקים ל־14 הימים שחלפו. ניתן למצוא את רשימת קובצי ההבדלים הזמינים כעת תחת
https://static.openfoodfacts.org/data/delta/index.txt.
כל שורה מייצגת קובץ שקיים תחת https://static.openfoodfacts.org/data/delta/{filename}.
שם הקובץ מכיל חותמת זמן יוניקס של השינוי הראשון והאחרון שבקובץ ה־JSON, כדי שניתן יהיה לייבא את קובצי ההפרש (לאחר החילוץ) בעזרת mongoimport בסדר אלפביתי.
נא לשים לב שעקב אופן ההתנהלות של mongoexport, בקובצי ההפרשים לא מתועדים מוצרים שנמחקו. כדי להסיר מוצרים שהוסרו ממסד הנתונים שלך, יהיה עליך לייבא את אוסף ה־MongoDB המלא.
יצוא נתונים ב־CSV
הנתונים של כל המוצרים או חלקם, ניתנים להורדה בתבנית CSV (נתמכת על ידי OpenOffice, Excel ועוד) דרך טופס החיפוש המתקדם.
קידוד הקובץ הוא יוניקוד UTF-8. התו שמפריד את השדות הוא <tab> (טאב).
יצוא נתונים ב־RDF
מסד הנתונים זמין גם בתצורת RDF. הכרזה בצרפתית.
API חי מסוג JSON
יש גם API בתצורת JSON לקריאת נתוני המוצרים. ב־API הזה במיוחד נעשה שימוש ביישומון לנייד של Open Food Facts עבור iPhone ועבור Android.
אנו משנים את ה־API מדי פעם בפעם אבל אנחנו משתדלים לשמור על תמיכה לאחור. נא לספר לנו אם נעזרת בו כדי שנוכל לספר לך על שינויים שעשויים לקרות.
הכתובת לקריאת נתוני מוצר היא: https://world.openfoodfacts.org/api/v0/product/[barcode].json
לדוגמה: https://world.openfoodfacts.org/api/v0/product/737628064502.json
תיעוד נוסף ניתן למצוא בוויקי. (הערה חשובה: העמוד מופרד לתת־עמודים לטובת READ - קריאה ו־WRITE - כתיבה). כרגע מתגבש תיעוד מוצלח יותר עם מקרי בוחן להצגת מוצר ומתן האפשרות למשתמשים שלך להוסיף את הנתונים הנדרשים כדי לקבל Nutri-Score, קבוצות NOVA ותוספים. ניתן לגשת אליו כאן.אנו מזמינים אותך להשתמש ב־API למטרות פעילות שוטפת, כל עוד כל קריאת API אחת = סריקה אמתית אחת מצד המשתמש. כל ניסיון לשאוב את מסד הנתונים דרך ה־API כנראה ייחסם כיוון שכל הנתונים מיוצאים מדי יום ומופיעים ממש בעמוד הזה.
כמו כן, שליחת כותרות HTTP עם קריאות ה־API שלך היא דרך מצוינת בה נוכל ליצור אתך קשר במקרה שיש תקלות כלשהן.
במקרה של ספק, או אם יש לך שאלות (אין דבר כזה שאלה טיפשית), ניתן לשאול ב־Slack :-)
יישומים לניידים מסוג Android ו־iPhone
הקוד ליישומון לנייד של Open Food Facts זמין דרך GitHub (Android ו־iOS). היישומון מאפשר למשתמשים לסרוק ברקוד של מוצרים, כדי לצפות בפרטי המוצר ולצלם ולשלוח תמונות ונתונים למוצרים חסרים.
היישומון ל־iOS פותח ב־Swift.
היישומון ל־Android פותח ב־Java.
אנו מזמינים אותך לעשות שימוש חוזר בקוד המקור (הפתוח) ולסייע לנו לשפר אותו, למען כולם, בכל רחבי העולם.
מעטפות וערכות SDK
כנראה שיש לנו מעטפת לשפת הפיתוח המועדפת עליך. אם כן, ניתן להשתמש בו ולשפר אותו. אם לא, ניתן לסייע ליצור אותו.
הם יאפשרו לך לצרוך נתונים, כמו גם לאפשר למשתמשים שלך לתרום נתונים חדשים
- Cordova: GitHub (היישומון הרשמי הישן של Open Food Facts)
- DART: GitHub
- Elixir: GitHub
- Go: GitHub
- NodeJS: GitHub
- PHP: GitHub
- PHP (Lararel): GitHub
- Python: GitHub
- React Native: GitHub
- Ruby: GitHub
דיון על נתונים, API ועל נתונים מיוצאים
ניתן להצטרף לחדר ה־Slack של Open Food Facts שזו הדרך המועדפת לשאול שאלות ולדבר על ה־API.
ניתן גם להצטרף לרשימות הדיונים כדי לדון ב־API ובתוצרים המיוצאים, לספר לנו על נגזרות ולקבל התרעות כשמוצגים שיפורים או שינויים ב־API. עליך לשלוח הודעת דוא״ל ריקה אל api-subscribe@openfoodfacts.org כדי להירשם.
יצירת קשר
לכל שאלה בנוגע לנתונים, ניתן ליצור אתנו קשר בכתובת contact@openfoodfacts.org