איך להשתמש ב-JSON Schema כדי לאמת את הנתונים שלך

מהי סכמת JSON?

סכמת JSON היא דרך סטנדרטית לתאר את המבנה, השדות הנדרשים וסוגי הערכים בנתוני ה-JSON שלך. אפשר לחשוב עליה כחוזה או תכנית המגדירה כיצד JSON תקין צריך להיראות. סכמת JSON נכתבת בעצמה בפורמט JSON, מה שהופך אותה לקריאה למכונה וקלה לעריכה.

מדוע לאמת עם סכמת JSON?

• למנוע באגים על ידי זיהוי נתונים שגויים או חסרים לפני שהם גורמים לבעיות.
• להבטיח עקביות נתונים בין צוותים, אפליקציות או API שונים.
• ליצור תיעוד באופן אוטומטי מתוך סכמות.
• לעזור לעורכים ולכלים לספק השלמה אוטומטית טובה יותר ועזרה בתוך השורה.

דוגמה פשוטה: סכמת יסוד

הנה אובייקט JSON בסיסי, ואחריו סכמת מינימום שבודקת את המבנה שלו:

{
  "name": "אליס",
  "age": 30
}

{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number" }
  },
  "required": ["name", "age"]
}

סכמה זו מוודאת שהאובייקט חייב להכיל "name" (מחרוזת) ו-"age" (מספר).

כיצד לכתוב סכמת JSON מותאמת

ניתן להגדיר חוקי אימות מתקדמים בסכמה שלך: להגביל ערכי שדות, להגדיר אובייקטים מקוננים או לקבוע גבולות מינימום/מקסימום למספרים. הנה דוגמה שמאמתת מערך של מוצרים:

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": { "type": "string" },
      "price": { "type": "number", "minimum": 0 },
      "tags": {
        "type": "array",
        "items": { "type": "string" }
      }
    },
    "required": ["id", "price"]
  }
}

שימוש ב-JSONValidator.dev לאימות סכמות

1. הדבק את נתוני ה-JSON בעורך הראשי.
2. הדבק את סכמת ה-JSON שלך בעורך הסכמות למטה.
3. לחץ על אמת JSON נגד סכמה זו.
4. סקור את תוצאות האימות, כאשר שגיאות מודגשות ומוסברות.

פתרון בעיות באימות סכמות

גורמים נפוצים לשגיאות אימות כוללים:

• שדה נדרש חסר בנתונים שלך.
• סוג ערך לא תואם לסכמה (לדוגמה, מחרוזת במקום מספר).
• הסכמה עצמה שגויה או מכילה שגיאות הקלדה.

סיכום

אימות באמצעות JSON Schema היא דרך חזקה להפוך את הנתונים שלך לחסינים ונטולי שגיאות. נסה ליצור סכמת JSON לנתונים שלך עם מחולל סכמות JSON שלנו ואמת אותם בזמן אמת!