Dart → JSON Schema 產生器

如何將 Dart class 轉為 JSON Schema（步驟指南）

這個線上轉換器（Dart class → JSON Schema）可從真實模型（DTO、struct、class）產生 JSON Schema，方便驗證 payload、分享契約，並生成 mock JSON。

1. 步驟 1：貼上 Dart 程式碼

   • 將要文件化的模型貼到左側編輯器。
   • 把被引用的型別也放在同一段程式碼中，便於產生 definitions。
   • 點擊 範例 載入範例，了解預期輸入格式。

2. 步驟 2：選擇 根 class（如需要）

   • 若偵測到多個 definitions，選擇與你的 API payload 相符的 root 型別。
   • 輸出 Schema 會以選中的 root 為中心，並包含引用型別的額外 definitions。

3. 步驟 3：檢視 JSON Schema 輸出

   • 重點檢查型別、必填/可選欄位，以及巢狀物件/陣列結構。
   • 當模型引用其他模型時，注意 definitions 以及 $ref 是否正確。
   • 複製或下載 Schema，用於驗證、文件或 schema-first 開發。

4. 步驟 4：驗證或產生 mock JSON

   • 點擊 產生 Mock 資料 即可開啟已預載 Schema 的 Mock 產生器。
   • 用真實 payload 驗證 Schema，及早發現破壞性變更。
   • 若你依賴更進階的 schema 組合（例如 anyOf/oneOf/allOf），建議用 Ajv 等完整 validator 再驗證一次。

相關工具

搭配這些工具一起使用：驗證 Schema、產生 mock payload、格式化 JSON 範例，並保持程式碼與契約一致。