נקודות מפתח לתכנון חוזי נתונים ב-JSON API
שישה דברים קשים מאוד לשינוי אחרי שחרור: מעטפות תשובה, פורמטי שגיאה, צורת עימוד, ייצוג מזהים וזמן, הסמנטיקה של null מול היעדר, ואבולוציית גרסאות.
בינוניכ-13 דקות קריאהעודכן 2026-10-30
פרקטיקה הנדסית
הכנסת JSON למערכות אמיתיות: איך להגדיר חוזי API, איך לנהל תצורה ו-fixtures, איך לטפל בתאימות גרסאות, ואיך לתחזק נתוני בדיקה.
5 מאמריםמאמרים בקטגוריה זו
ניהול JSON עבור תצורה, fixtures ונתונים מקומיים
תצורה חייבת להיות בשכבות ומאומתת; fixtures חייבים להיות דטרמיניסטיים, קריאים וניתנים ל-diff. אם שני סוגי הקבצים האלה מנוהלים גרוע, עלות פתרון התקלות נשארת גבוהה זמן רב.
מתחילכ-10 דקות קריאהעודכן 2026-10-30
כששני מסמכי JSON נבדלים: diff לפי מיקום, diff לפי id, או נרמול קודם
חמישים רשומות הופכות לחמישים ואחת וה-diff מדווח על חמישים ואחת שינויים. הסבר על false positives של text diff, התאמת מערכים לפי id, נרמול עם jq ופאצ'ים ישימים.
מתחילכ-6 דקות קריאהעודכן 2026-10-30
התנגשויות מיזוג Git בקבצי JSON: למה merge=union כותב JSON שבור
merge=union מכניס JSON שבור ועדיין מדווח על הצלחה. הסבר על driver מיזוג תלת-כיווני מודע למפתחות עבור JSON, ועוד שלושה הרגלים שמצמצמים התנגשויות.
בינוניכ-7 דקות קריאהעודכן 2026-10-30
גרסאות של חוזי JSON: תאימות, deprecation והעברת נתונים
הוספת שדה אינה בטוחה אוטומטית. הסבר על גבולות תאימות, שדות גרסה, חלונות deprecation, העברה בכתיבה כפולה, בדיקות חוזה ומדדי canary.
מתקדםכ-10 דקות קריאהעודכן 2026-10-31