審閱日期 2026-08-28

從真實樣本建立實用 JSON Schema

先產生草稿,再把偶然觀察改成明確且有意義的規則。

從真實樣本建立實用 JSON Schema從真實樣本建立實用 JSON Schema輸入驗證轉換核對

實際輸入範例

{"id":42,"tags":["admin"]}

預期輸出

{"type":"object","properties":{"id":{"type":"integer"}}}

可重現操作方法

  1. 保留原始資料,另建一份最小且具代表性的測試樣本。
  2. 轉換前先執行嚴格解析或格式驗證。
  3. 記錄所有選項,比對筆數與結構,最後在接收系統中測試。

常見錯誤案例

單一樣本無法揭示選填、可為 null 或無效案例。

縮小失敗案例時必須保留造成問題的結構,才能分辨是輸入損壞或工具不支援。

技術限制

推論無法發現未文件化的業務限制。

預覽成功不代表格式歧義或下游系統要求已經消失。

安全與隱私說明

使用合成樣本,並要求人工審查 Schema。

本機處理可降低傳輸風險,但無法防護已遭入侵的瀏覽器、不安全擴充套件、剪貼簿紀錄或後續誤用。

驗證清單

開啟相關工具