Hướng dẫn JSON Schema

JSON Schema mô tả hình dạng dữ liệu JSON và xác thực tài liệu tự động.

Từ khóa chính

type giới hạn kiểu. properties định nghĩa trường. required liệt kê khóa bắt buộc. items mô tả phần tử mảng.

Schema ví dụ

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

enum và const

enum cho phép tập giá trị cố định. const yêu cầu đúng một giá trị.

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

$ref và schema tái sử dụng

$ref trỏ đến định nghĩa khác để tài liệu phức tạp dễ bảo trì.

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