נתונים
תנאי גזירה
מסד הנתונים Open Food Facts זמין בכפוף לרישיון Open Database (מסדי נתונים).
התוכן הפרטני במסד הנתונים כפוף לרישיון Database Contents (תכני מסדי נתונים).
תמונות המוצרים זמינות בכפוף לרישיון 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
מסד הנתונים השלם זמין גם בתצורתJSONL (לפעמים נקרא גם LDJSON או NDJSON) בו כל שורה היא פריט JSON. הוא מייצג את אותם הנתונים כמו בייצוא של MongoDB. הקובץ דחוס ב־gzip.
יצוא נתונים ב־CSV
הנתונים של כל המוצרים או חלקם, ניתנים להורדה בתבנית CSV (נתמכת על ידי LibreOffice, Excel ועוד תוכנות גיליונות נתונים) דרך טופס החיפוש המתקדם.
- קישורים
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv (CSV גולמי)
- https://static.openfoodfacts.org/data/en.openfoodfacts.org.products.csv.gz (CSV דחוס בתצורת GZIP)
קידוד הקובץ הוא Unicode UTF-8. התו המפריד בין שדות הוא <tab> (טאב).
יצוא נתונים ב־RDF
מסד הנתונים זמין גם בתצורת RDF. אפשר לקרוא את ההכרזה בצרפתית.
עקרונות כלליים
אפשר להוריד את כל התמונות ואת תוצאות המרת תמונה לטקסט מהשרת שלך או מ־AWS (דרך התוכנית AWS Open Data). אפשר לפנות לתיעוד שלנו כדי ללמוד עוד על איך להוריד תמונות.
תיעוד OpenAPI ל־API בתצורת JSON
API בתצורת JSON גם כן זמין לטובת קריאת נתונים על מוצר. ה־API הזה במיוחד משמש את היישומון לניידים של Open Food Facts עבור iPhone ו־Android.
אנו משפרים את ה־API עם הזמן אך אנו מקפידים מאוד לשמור על תאימות לאחור. נא ליצור קשר אם הוא משמש אותך, כדי שנוכל לעדכן על שינויים אפשריים.
כתובת לקריאת נתוני מוצר: https://world.openfoodfacts.org/api/v2/product/[barcode].json
לדוגמה: https://world.openfoodfacts.org/api/v2/product/737628064502.json
נא לשים לב שאם הפלט הוא קצת מעבר למה שציפית, אפשר לסנן אותו, כפי שמתואר ב־API.
דרושה עזרה עם OpenAPI
אנו נשמח מאוד לסיים את תיעוד ה־API, להוסיף מקרי בוחן ולייצר אוטומציה של יצירת SDK. אם OpenAPI זה הצד החזק שלך, מאוד נשמח לקבל עזרה.אנו מזמינים אותך להשתמש ב־API למטרות פעילות מבצעית, כל עוד כל קריאת API שוות ערך לסריקה אמתית של משתמש. כל ניסיון לדלות את מסד הנתונים כולו דרך ה־API ייחסם כיוון שתוצאי ייצוא מלאים יומיים זמינים בעמוד זה ממש.
כמו כן, שליחת כותרות HTTP עם קריאות ה־API שלך היא דרך מצוינת בה נוכל ליצור אתך קשר במקרה שיש תקלות כלשהן.
במקרה של ספק או אם יש לך שאלות (אין דבר כזה שאלות טפשיות), אפשר לפנות אלינו בערוץ #api ב־Slack :-)
API ניסיוני עם XML
לדוגמה: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
לדוגמה: https://world.openfoodfacts.org/api/v2/product/737628064502.xml
ה־API הזה לא מתוחזק באופן פעיל, ולא מתועד רשמית.מעטפות וערכות SDK
כנראה שיש לנו מעטפת לשפת הפיתוח המועדפת עליך. אם יש לנו, ניתן להשתמש בה ולשפר אותה. אם אין לנו, ניתן לעזור ביצירתה.
הם יאפשרו לך לצרוך נתונים, כמו גם לאפשר למשתמשים שלך לתרום נתונים חדשים
עקרונות כלליים כדי לשמח את המשתמשים שלך
- Cordova: GitHub (היישומון הרשמי הישן של Open Food Facts).
- DART: GitHub
- Elixir: GitHub
אם המשתמשים שלך לא מצפים לתוצאות מיידית (למשל: יישומוני מאגרים)
- מגישים תמונות (חזית/תזונה/רכיבים): הדבר הכי פחות מעיק על הלקוחות שלך
- רובוט הבינה המלאכותית של Open Food Facts - Robotoff - יגזור נתונים מהתמונות
- עם הזמן, יישומונים אחרים וקהילת Open Food Facts ימלאו את פערי הנתונים
אם המשתמשים שלך מצפים לתוצאות מיידית (למשל: יישומוני תזונה)
- מגישים עובדות תזונתיות + קטגוריה > מקבלים Nutri-Score
- מגישים רכיבים > מקבלים קבוצת NOVA (על אולטרה עיבוד של מזון), תוספים, מעוררי רגישות, רכיבים מיוצבים, צמחונות, טבעונות…
- מגישים קטגוריה + תוויות > מקבלים בקרוב את ה־Eco-Score (על ההשפעה על איכות הסביבה)
יישומון Android/iPhone/Flutter לניידים
הקוד של היישומונים הרשמיים של Open Food Facts זמין ב־GitHub Flutter Kotlin Android Swift iOS
אנחנו שוקלים להפוך את בסיסי הקוד של Kotlin ו־Swift ל־SDKs של Kotlin ו־Swift, נשמח לעזרה :-)
היישומון מאפשר למשתמש לסרוק ברקודים של מוצרים, כדי לצפות בפרטי המוצר וכדי לצלם ולהגיש תמונות ונתונים שחסרים על המוצר.
אנו מזמינים אותך לעשות שימוש חוזר בקוד המקור (הפתוח) ולסייע לנו לשפר אותו, למען כולם, בכל רחבי העולם.
ערכות SDK
- Cordova: GitHub (היישומון הרשמי הישן של Open Food Facts)
- DART: GitHub
- Elixir: GitHub - ערוץ הדיונים
- Go: GitHub - ערוץ הדיונים
- Java: GitHub - ערוץ הדיונים
- Kotlin: GitHub - ערוץ הדיונים
- NodeJS: GitHub - ערוץ הדיונים
- PHP: GitHub - ערוץ הדיונים
- PHP (Laravel): GitHub - ערוץ הדיונים
- Python: GitHub - ערוץ הדיונים
- React Native: GitHub - ערוץ הדיונים
- Ruby: GitHub - ערוץ הדיונים
- Rust: GitHub - ערוץ הדיונים
דיון על נתונים, API ועל נתונים מיוצאים
אפשר לעיין בשו״ת הנפוצות על API וייצוא נתונים ושאלות נפוצות על Open Food Facts
ניתן להצטרף לחדר ה־Slack של Open Food Facts שזו הדרך המועדפת לשאול שאלות ולדבר על ה־API. נא לשאול את השאלות שלך בערוץ #api
אפשר לפתוח שרשור במאגר תיעוד ה־API שלנו
לכל שאלה בנוגע לנתונים, ניתן ליצור אתנו קשר בכתובת contact@openfoodfacts.org