เครื่องมือสร้าง JSON Schema

สิ่งที่การอนุมานทำได้ดี

• ชนิดข้อมูล: string, number, integer, boolean, null, array, object
• ความเป็น null ได้: ฟิลด์ที่เป็น null ในตัวอย่างหนึ่งและเป็นสตริงในอีกตัวอย่างหนึ่ง จะกลายเป็น ["string", "null"]
• สมาชิกของอาร์เรย์: อาร์เรย์ที่มีชนิดเดียวกันจะสร้างสคีมา items เพียงชุดเดียว ส่วนอาร์เรย์ที่มีหลายชนิดจะสร้าง prefixItems
• enum: หากค่าที่พบทั้งหมดมาจากชุดขนาดเล็ก (ปรับค่าได้ ค่าเริ่มต้นคือ 10 ค่าที่แตกต่างกัน) จะสร้าง enum ออกมา
• จำเป็น: เมื่อมีหลายตัวอย่าง อินเตอร์เซกชันของคีย์จะกลายเป็น required; เมื่อมีตัวอย่างเดียว คีย์ทั้งหมดจะจำเป็น เว้นแต่คุณจะเลือกไม่ใช้
• รูปแบบ: สตริงที่ตรงกับวันที่ตามมาตรฐาน ISO-8601 อีเมล หรือ URI จะได้รับ format ที่อนุมานได้

สิ่งที่การอนุมานไม่อาจรู้ได้

• เจตนากับตัวอย่าง: ตัวอย่าง age: 25 อนุมานได้ว่าเป็น type: integer แต่ไม่อาจรู้ได้ว่าคุณยอมรับ null ด้วยหรือไม่ ควรส่งตัวอย่างหลายชุดที่ครอบคลุมกรณีขอบเขต
• ข้อจำกัด: minLength, maximum, pattern, คุณต้องเพิ่มด้วยตนเอง การอนุมานจะไม่เดาขอบเขตจากตัวอย่าง
• ตรรกะทางธุรกิจ: เงื่อนไข “ต้องกำหนดค่าเพียงหนึ่งในสามฟิลด์นี้เท่านั้น” ต้องใช้ oneOf, ไม่สามารถอนุมานได้
• การอ้างอิง: เครื่องมือจะสร้างสคีมาแบบแบน หากต้องการแยกรูปแบบที่ซ้ำกันออกเป็น $defs ให้ทำหลังจากการสร้างเสร็จสิ้น

ตัวอย่างผลลัพธ์

จากตัวอย่างชุดเดียว:

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

สคีมาที่อนุมานได้ (draft 2020-12):

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

ข้อผิดพลาดที่พบบ่อย

• อนุมานจากตัวอย่างชุดเดียว สคีมาจะโอเวอร์ฟิต, ทุกฟิลด์กลายเป็นจำเป็น และไม่ยอมรับ null เลย ควรป้อนตัวอย่างที่หลากหลายอย่างน้อย 5–10 ชุดเสมอ
• ใช้ integer ทั้งที่ต้องการ number หากตัวอย่างใดมีทศนิยม ชนิดที่อนุมานได้จะเป็น number; หากทั้งหมดเป็นจำนวนเต็ม จะเป็น integer สำหรับฟิลด์ที่เป็นได้ทั้งสองแบบ ควรใส่ตัวอย่างที่มีทศนิยมด้วย
• ลืมฟิลด์ที่เป็นตัวเลือก ฟิลด์ที่ปรากฏใน 4 จาก 5 ตัวอย่างแต่ขาดไปใน 1 ตัวอย่างจะกลายเป็นตัวเลือก, ซึ่งเป็นไปตามที่ตั้งใจ หากทั้ง 5 ตัวอย่างบังเอิญมีฟิลด์นั้น สคีมาจะทำเครื่องหมายว่าจำเป็น แม้ว่าในความเป็นจริงมันจะเป็นตัวเลือกใน API ของคุณก็ตาม