คู่มือ JSON Schema

JSON Schema อธิบายรูปร่างของข้อมูล JSON และตรวจสอบเอกสารอัตโนมัติ

คีย์เวิร์ดหลัก

type จำกัดชนิด properties กำหนดฟิลด์ required ระบุคีย์ที่ต้องมี items อธิบายสมาชิกอาร์เรย์

ตัวอย่างสคีมา

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

enum และ const

enum อนุญาตชุดค่าคงที่ const ต้องการค่าเดียว

{"role": {"enum": ["admin", "editor", "viewer"]}}

$ref และสคีมาที่ใช้ซ้ำได้

$ref ชี้ไปยังนิยามอื่นเพื่อให้เอกสารซับซ้อนดูแลง่าย

{"$defs":{"id":{"type":"integer"},"type":"object","properties":{"id":{"$ref":"#/$defs/id"}}}