🌐 ZH-TW

🧬 JSON Schema 產生器

貼上範例 JSON 資料即可自動推斷 draft-07 JSON Schema。它會偵測每個值的型別,標示物件鍵值為必填,並合併陣列項目的 schema。

指南

瞭解更多

01

1. 什麼是 JSON Schema

JSON Schema 是一種描述 JSON 資料結構、型別與限制的標準,廣泛用於驗證 API 請求與回應、檢查設定檔,以及自動化文件。此工具可從單一 JSON 範例產生 draft-07 schema,不再從頭手動撰寫。

02

2. 推斷規則

字串、整數、浮點數、布林值與 null 會對應到 string、integer、number、boolean 與 null 型別。物件會取得 properties 並將每個出現的鍵標示為必填;陣列則會合併所有元素的 schema 成 items。當陣列元素含有不同鍵時,只有每個元素都存在的鍵才會保留為必填。

03

3. 精進結果

自動推斷僅是起點。實際的 schema 通常還會加入 format(email、date-time)、最小/最大長度、enum、regex 模式,以及可選欄位的調整。為了效能,輸入資料會受到節點數上限限制,因此先以具代表性的範例建立草稿,再微調限制條件。

常見問題

會產生哪個 JSON Schema 版本?
會產生 draft-07 schema。$schema 欄位會設為 http://json-schema.org/draft-07/schema#。
為什麼每個鍵都會被標為必填?
範例中出現的鍵會被推斷為一定會出現,因此標示為必填。請在產生後從 required 陣列中移除可選欄位。
我的 JSON 會傳到伺服器嗎?
不會。推斷完全在您的瀏覽器中進行,資料永遠不會傳送到伺服器。
如果陣列元素有不同形狀怎麼辦?
這些 schema 會被合併:只有共同鍵保留為必填,而混合型別會變成 type 陣列(integer + number 會合併為 number)。