01
1. 什麼是 JSON Schema
JSON Schema 是一種描述 JSON 資料結構、型別與限制的標準,廣泛用於驗證 API 請求與回應、檢查設定檔,以及自動化文件。此工具可從單一 JSON 範例產生 draft-07 schema,不再從頭手動撰寫。
貼上範例 JSON 資料即可自動推斷 draft-07 JSON Schema。它會偵測每個值的型別,標示物件鍵值為必填,並合併陣列項目的 schema。
JSON Schema 是一種描述 JSON 資料結構、型別與限制的標準,廣泛用於驗證 API 請求與回應、檢查設定檔,以及自動化文件。此工具可從單一 JSON 範例產生 draft-07 schema,不再從頭手動撰寫。
字串、整數、浮點數、布林值與 null 會對應到 string、integer、number、boolean 與 null 型別。物件會取得 properties 並將每個出現的鍵標示為必填;陣列則會合併所有元素的 schema 成 items。當陣列元素含有不同鍵時,只有每個元素都存在的鍵才會保留為必填。
自動推斷僅是起點。實際的 schema 通常還會加入 format(email、date-time)、最小/最大長度、enum、regex 模式,以及可選欄位的調整。為了效能,輸入資料會受到節點數上限限制,因此先以具代表性的範例建立草稿,再微調限制條件。