Panduan JSON Schema

JSON Schema menerangkan bentuk data JSON dan mengesahkan dokumen secara automatik.

Kata kunci teras

type menghadkan jenis. properties mentakrifkan medan. required menyenaraikan kunci wajib. items menerangkan elemen array.

Contoh skema

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

enum dan const

enum membenarkan set nilai tetap. const memerlukan satu nilai tepat.

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

$ref dan skema boleh guna semula

$ref menunjuk ke definisi lain supaya dokumen kompleks mudah diselenggara.

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