JSON轉Smithy模型
工具用的順手嗎？
你的回饋能幫助我們做得更好
將JSON數據結構自動轉換為Smithy IDL模型定義，簡化API設計與服務建模流程。
概覽
了解工具能解決的問題、計算或處理邏輯，以及資料邊界。
這項工具把一份 JSON 範例推導成 Smithy IDL 型別定義草稿。Smithy 是描述服務介面與資料模型的語言；其中的 shape（形狀）可代表基本型別或由多個成員組成的結構。輸入樣本能提供欄位名稱、巢狀關係及當次出現的值型別，方便開發者開始整理模型。
例如 JSON 物件可作為結構成員的線索，物件陣列則可顯示重複項目的欄位形狀。輸出以可閱讀、可編輯的 Smithy IDL 文字呈現，適合複製到專案草稿或下載成 .smithy 檔，再由熟悉介面契約的人員檢查。
Smithy 常見聚合形狀包括 structure、list 和 map：structure 用具名成員描述一筆資料，list 表示有順序的同類成員集合，map 則以鍵和值配對。JSON 樣本只呈現一種或少數實際值，工具依可見資料推導可能的形狀；欄位的業務意義不會自動從值本身得知。
Smithy IDL 的模型需要 namespace 才能宣告形狀。這個轉換流程聚焦在型別定義；單靠一筆資料無法推導服務、操作、認證、欄位必填規則或完整約束。相關語法可參考 Smithy IDL 規範與 聚合型別規範（核驗日期：2026-09-30）。
指南
依步驟完成操作，並透過範例核對輸入與結果。
輸入可解析的 JSON 物件或陣列。欄位名稱與字串值使用雙引號，確認大括號、方括號成對，最後一個欄位後不要多加逗號。若資料有多種物件形態，挑選能涵蓋主要欄位的樣本。
頂層名稱預設為 Root，可改成符合資料用途的名稱，例如 Order。Smithy 選項中的「僅型別定義」預設開啟，可依需求調整；進階推斷選項則可展開檢視。
比對 JSON 與 IDL 中的成員名稱、巢狀型別及集合成員。結果會隨輸入或選項更新；確認後可複製文字，或下載以型別名稱命名的 .smithy 檔。
情境
查看這項工具在不同工作與生活流程中的用法。
維護者手上有一份 JSON 回應，但尚未整理成 Smithy 資料形狀時，可先轉出草稿，逐欄確認成員與巢狀清單，再回到正式介面契約補齊語意。
團隊可用代表性樣本產生一致的起點，讓參與者集中檢視型別、命名與重複結構。評審時應一併查看其他狀態或版本的資料，避免把單次輸出當成全部可能情況。
問答
集中解答常見疑問與容易混淆的問題。
通常沒有足夠元素可供判斷。請補上一筆有代表性的陣列物件，或在模型草稿中依介面契約手動指定成員型別；不要只憑欄位名稱猜測。
不是。它根據樣本產生型別定義草稿，不會因此包含完整服務與操作、認證、欄位約束或文件說明。正式使用前，請按專案採用的 Smithy 版本及規則審閱並執行模型驗證；Smithy 快速入門說明了服務、資源、操作與 traits 等模型元素。
單一 JSON 樣本只記錄當次可見的資料。它不能證明某欄位永遠存在，也不能涵蓋字串、數字或空值等所有變化。若介面有多種狀態，請加入更多樣本並核對正式契約。
須知
使用前了解適用範圍、結果限制與必要提醒。
推斷結果反映輸入樣本中看得到的鍵和值；缺少欄位、空物件、空陣列、可變型別與特定業務限制，可能無法從樣本判定。請由 API 維護者確認哪些成員必填、允許哪些值，以及不同回應是否共用同一結構。
正式採用前，請以 Smithy 工具鏈檢查輸出語法和模型規則，並補上實際需要的 namespace、文件、traits、服務與操作定義。貼入資料前也請移除不必要的個人資訊、存取憑證及令牌。
推薦
查找相關工具、專題與可用的 API 能力。
