דילוג לתוכן
חיפוש באתר

כללי

מה זה JSON? הפורמט שבו מערכות מעבירות נתונים

מה זה JSON, איך הוא נראה, הכללים שבגללם הוא נשבר, ואיפה הוא פוגש את האתר שלכם: API, וורדפרס, Webhooks ונתונים מובנים JSON-LD.

· 1 צפיות ·

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

מה זה JSON: דוגמה אחת

כך יכול להיראות כרטיס של עסק באינדקס, כ-JSON:

{
  "name": "סטודיו לדוגמה",
  "city": "פתח תקווה",
  "open_now": true,
  "rating": 4.8,
  "services": ["עיצוב", "פיתוח"],
  "owner": null
}

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

הכללים — ולמה JSON נשבר

לפי המדריך של MDN, JSON נראה כמו אובייקט של JavaScript, אבל הכללים שלו קשוחים יותר. רוב השגיאות שאני רואה מגיעות מאחד מאלה:

  • מירכאות כפולות בלבד — גם לשמות השדות וגם למחרוזות. מירכאות בודדות שוברות את הקובץ.
  • בלי פסיק אחרי הפריט האחרון ברשימה או באובייקט.
  • בלי הערות — אין ב-JSON דרך לכתוב הערה.
  • רק סוגי נתונים מסוימים — מחרוזות, מספרים, true/false, null, אובייקטים ורשימות. אין תאריכים כסוג מיוחד (תאריך נכתב כמחרוזת), אין פונקציות ואין undefined.

שגיאה אחת כזו, ולא משנה כמה קטנה, הופכת את כל הקובץ ללא תקין — והמערכת שמקבלת אותו פשוט לא תקרא אותו.

איפה JSON פוגש את האתר שלכם

שימוש מה עובר כ-JSON
API וחיבורים בין מערכות לידים מטפסים, הזמנות, מלאי, סטטוס תשלום
REST API של וורדפרס פוסטים, עמודים ומשתמשים — לאפליקציה או לאתר אחר
נתונים מובנים (JSON-LD) תיאור העסק, המאמר או המוצר עבור מנועי חיפוש
Webhooks הודעה ממערכת חיצונית שמשהו קרה — למשל תשלום שעבר
קובצי הגדרות הגדרות של כלים, תוספים וחבילות קוד

API

כשהאתר מדבר עם מערכת אחרת — סליקה, משלוחים, CRM — הוא שולח בקשה ומקבל תשובה, וכמעט תמיד התשובה היא JSON. ההסבר הכללי נמצא במאמר מה זה API, והדוגמה של וורדפרס במאמר REST API בוורדפרס.

JSON-LD: אותו פורמט, בשביל גוגל

JSON-LD הוא JSON עם כמה שדות מיוחדים (כמו @context ו-@type), שמתאר לגוגל מה יש בעמוד: עסק, מאמר, מוצר. זה הפורמט שגוגל ממליצה עליו לנתונים מובנים, והוא יושב בתוך העמוד בלי שהגולש רואה אותו. באתר הזה, למשל, יש גרף אחד של נתונים מובנים שמחבר את הארגון, המייסד, השירותים והמאמרים — פירטתי במאמר נתונים מובנים.

איך בודקים שקובץ JSON תקין

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

JSON מול XML

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

שאלות נפוצות

האם JSON הוא שפת תכנות?

לא. זה פורמט נתונים בלבד — הוא לא מריץ שום דבר. הוא מתאר מידע, ותוכנה אחרת קוראת אותו.

אפשר לכתוב עברית ב-JSON?

כן. JSON תומך ב-Unicode, ועברית עוברת בלי בעיה כל עוד הקובץ שמור בקידוד UTF-8.

מה ההבדל בין JSON ל-JavaScript?

כל JSON תקין הוא גם ערך תקין ב-JavaScript, אבל לא להפך: ב-JavaScript מותר הרבה יותר — מירכאות בודדות, הערות, פונקציות.

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

אהבתם את המאמר?

בואו נבנה יחד!

מתכננים אתר חדש, פורטל, חנות או מערכת ניהול תוכן? ספרו לי על הפרויקט, ואחזור אליכם בעצמי. אני מתחיל תמיד בהבנת הצרכים העסקיים והטכניים — ורק אז ממליץ על הפתרון הנכון.

חיפוש באתר