מחולל
JSON schema
הדביקו כל JSON וקבלו שלושה דברים בבת אחת: JSON Schema של draft 2020-12, ממשקי TypeScript ותיאור באנגלית פשוטה של הצורה; עם שדות required, enums ו-formats שמוסקים מהנתונים עצמם.
הדבקה אחת, שלוש תשובות
Yetty נותן ל-AI שלכם תמונה מלאה של האתר דרך MCP; עמודים, אוספים ושדות שהוא יכול לערוך בבטחה.
איך הצורה
מוסקת
הצורות ממוזגות
מערך של אובייקטים לא נשפט לפי הפריט הראשון שלו. כל אובייקט ממוזג לצורה אחת, כך ששדה שמופיע רק בפריט 40 עדיין נכנס לסכימה; כאופציונלי.
required מנוכחות
שדה שנוכח בכל אובייקט שנדגם נוחת ב-required. חסר במקום כלשהו, ולו פעם אחת, והוא הופך לאופציונלי; הקריאה הכנה של העדות שהדבקתם.
enums מחזרה
כששדה מחרוזת מקבל תמיד רק קומץ ערכים; status, plan, role; והערכים האלה חוזרים, הסכימה מקבעת אותו כ-enum במקום מחרוזת רופפת.
formats מדפוסים
ערכים שנראים באופן עקבי כמו dates, date-times, emails, URLs או UUIDs מקבלים את מילת ה-format התואמת, כך שמאמתים באמת יכולים לבדוק אותם.
שלושה מבטים, אמת אחת
ה-JSON Schema, ממשקי ה-TypeScript וסיכום האנגלית הפשוטה כולם מרונדרים מאותה צורה ממוזגת; הם לעולם לא יכולים לסתור זה את זה.
דגימה היא דגימה
הסכימה מתארת את ה-JSON שהדבקתם, לא כל JSON שהמערכת שלכם עשויה אי פעם לייצר. התייחסו אליה כטיוטה ראשונה חזקה ושחררו את מה שאתם יודעים שמשתנה.
אנשים גם שואלים
איך יוצרים JSON Schema מקובץ JSON לדוגמה?
הדביקו את הדוגמה בעמוד הזה והסכימה מופיעה מיד; draft 2020-12, עם טיפוסים שמוסקים מהערכים, required שמפרט את השדות שתמיד קיימים, ופורמטים של מחרוזת כמו date, email, uri ו-uuid שמזוהים מהנתונים עצמם. הכול רץ לגמרי בדפדפן שלכם, כך שקובץ הגדרות או תגובת API עם סודות בתוכה לעולם לא יוצאים מהמחשב.
איך זה מחליט אילו שדות הם required ואילו אופציונליים?
מנוכחות. כשה-JSON שלכם הוא מערך של אובייקטים, הצורות של כל האובייקטים ממוזגות: שדה שמופיע בכל אובייקט נוחת ב-required, שדה שחסר ולו באחד הופך לאופציונלי. בלשונית TypeScript אותה לוגיקה מופיעה כסימן שאלה על המאפיין, ולשונית האנגלית הפשוטה אומרת "לפעמים חסר"; שלושה מבטים על צורה ממוזגת אחת.
אפשר לקבל ממשקי TypeScript מ-JSON בלי להתקין כלום?
כן; לשונית TypeScript בונה ממשקים מקוננים מאותה צורה שהוסקה: אובייקטים הופכים לממשקים בעלי שם, מערכים הופכים לטיפוסי T[], שדות שלעיתים נעדרים מקבלים את סימן האופציונליות, וערכים מעורבים הופכים לטיפוסי union. העתיקו את הלשונית ישר לקוד שלכם; אין חבילת npm, אין הרשמה ואין העלאה מעורבת.