JSON Schema 校驗入門：用模式約束接口數據

什麼是 JSON Schema，如何用它校驗 API 返回的 JSON 是否合法，附可複製的 draft-07 示例。

什麼是 JSON Schema

JSON Schema 是一份描述 JSON 數據「應該長什麼樣」的 JSON 文檔，常見版本為 draft-07。它用 type、required、properties、enum 等關鍵字聲明字段類型與約束，常用來校驗接口請求/響應、配置文件是否合規。

寫一個最小 Schema

下面這段 schema 要求對象必須包含 name（字符串）和 age（非負整數），role 只能是 user/admin：

在 ToolBox 中校驗

打開 JSON Schema 校驗器，左側粘貼數據、右側粘貼 schema，點擊校驗即可看到逐字段結果。把示例數據故意改成 "age": -3 會立即報「minimum」錯誤。

常見校驗錯誤

type mismatch：字段類型不符；required：缺少必填字段；enum：值不在允許集合；additionalProperties：出現了 schema 未聲明的字段（可設為 false 嚴格校驗）。