JSON Schema 驗證器

JSON 資料

1
2
3
4
5
6
7
8
9
10

JSON Schema(架構)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

驗證結果

開始驗證

輸入 JSON 與 Schema,以驗證資料結構與 constraints

驗證型別與結構

檢查 required 欄位

驗證限制與 formats

如何用 JSON Schema 驗證 JSON(步驟指南)

以 Schema 契約驗證 API 回應、設定檔與 payload samples,適合用於除錯、文件化與契約測試。

  1. 步驟 1:貼上 JSON 資料

    • 把 JSON 貼到 JSON 資料 編輯器。
    • 如果 JSON 來自檔案、URL 或剪貼簿,可使用匯入。
  2. 步驟 2:貼上 JSON Schema

    • 把 Schema 貼到 JSON Schema(架構) 編輯器。
    • 先聚焦核心結構: type, properties, required, items.
  3. 步驟 3:閱讀驗證結果

    • 右側會顯示欄位 valid 以及 errors 清單。
    • 用錯誤路徑定位到不符合的欄位位置。
  4. 步驟 4:修正資料或 Schema

    • 若資料有誤,修正 payload(缺欄位、型別錯誤)。
    • 若契約變更,更新 Schema 後再重新驗證。
  5. 步驟 5:在 CI 使用嚴格 validator

    • 若需要 production 級驗證(draft 支援、 $ref、組合),建議在 CI 中使用完整 JSON Schema validator。
    • 把 Schema 版本化,並用真實 fixtures 做契約測試。

關於 JSON Schema 進階功能的提醒

  • 此驗證器刻意輕量化,主要支援核心 keywords( type, properties, required, items)。
  • 若 Schema 依賴 $ref, anyOf, oneOf, allOf 等進階功能,可能需要更完整的 validator。
範例:用 schema 驗證 JSON
// JSON data
{ "id": 1, "name": "Maeve Winters" }

// JSON Schema
{
  "type": "object",
  "properties": {
    "id": { "type": "integer" },
    "name": { "type": "string" },
    "email": { "type": "string" }
  },
  "required": ["id", "name", "email"]
}

// Result
{
  "valid": false,
  "errors": ["root: Missing required property 'email'"]
}

相關工具

產生 schema、生成 mock payload,並在驗證前先清理 JSON。

常見問題

什麼是 JSON Schema 驗證?

JSON Schema 驗證是檢查 JSON 文件是否符合指定 Schema 的流程,會驗證型別、required 欄位、constraints 與結構規則。

如何用 Schema 驗證 JSON?

在左側輸入 JSON 資料,在 Schema 區貼上 JSON Schema。驗證會在你輸入時自動執行。

可能遇到哪些驗證錯誤?

常見錯誤包含:型別不匹配、缺少 required 欄位、出現不允許的額外欄位、字串長度限制不符、數值超出 min/max 等。

可以使用自訂 JSON Schema 嗎?

可以。不過此驗證器偏向輕量,主要聚焦 type/properties/required/items 等核心 keywords,不會解析 $ref,也不會完整評估進階組合 keywords。

JSON Schema 驗證器 | JSONSwiss