JSON Swiss 標誌

JSON Swiss

Schema 資料庫

顯示 8 / 8 個 Schema

Application Configuration

設定複雜

Complete application configuration with all settings

51個欄位 · 4層深度
configsettingsapplication+1
產生

Basic User Profile

使用者管理簡單

Simple user profile with essential information

7個欄位 · 1層深度
userprofilebasic+1
產生

Complete User Profile

使用者管理中等

Comprehensive user profile with personal and contact information

36個欄位 · 3層深度
userprofilecomplete+2
產生

Financial Transaction

金融中等

Complete financial transaction record

37個欄位 · 3層深度
transactionpaymentfinancial+1
產生

Order Details

電商複雜

Complete order with items, customer, and payment information

44個欄位 · 3層深度
ordercheckoutpayment+1
產生

Paginated API Response

API中等

Standard paginated API response with metadata

20個欄位 · 2層深度
apiresponsepagination+1
產生

Product Catalog

電商中等

E-commerce product with pricing and inventory

42個欄位 · 3層深度
productcataloginventory+1
產生

Social Media Post

社群中等

Social media post with engagement metrics

37個欄位 · 4層深度
socialpostengagement+1
產生

如何使用 JSON Schema 資料庫（步驟指南）

瀏覽常見 payload（使用者、商品、API 回應等）的 JSON Schema 範本，並進一步產生 mock JSON、驗證契約、把穩定範例轉成強型別程式碼。

  1. 步驟 1：依情境搜尋

    • 用搜尋框依名稱、tags 或情境關鍵字查找（例如「使用者資料」「分頁」「商品目錄」）。
    • 搭配分類、複雜度與 tags 快速縮小範圍。

  2. 步驟 2：評估 Schema 結構

    • 檢查關鍵欄位、required、formats 與 constraints 是否符合預期。
    • 優先選擇與 API 契約形狀相符的範本（不只看領域名稱）。

  3. 步驟 3：複製或下載

    • 把 Schema 複製到 repo 中，與 API 程式碼與文件一起版本化。
    • 下載為 .json 檔案，便於分享或工具處理。

  4. 步驟 4：產生 mock 與 fixtures

    • 開啟 Mock 產生器，產生更真實的範例 JSON 用於測試與 Demo。
    • 使用 seed + locale，讓資料在不同環境也能一致可重現。

  5. 步驟 5：驗證與產生程式碼

    • 開發過程中用 Schema 驗證真實 payload。
    • 由穩定範例產生 TypeScript/Java/etc.，讓 client 與 server 更一致。

關於 JSON Schema 進階功能的提醒

  • 部分 Schema 會依賴進階 keywords，例如 $ref, anyOf, oneOf, 以及 allOf。
  • 不同 validator 對 drafts 與 keywords 的支援不同；若要嚴格契約測試，建議在 CI 使用完整 validator。
範例：範本 schema → mock JSON 流程
// 1) Pick a schema template (user-profile, product-catalog, etc.)
// 2) Open Mock Generator and configure locale + seed + batch size
// 3) Download mock-data.json and use it as a fixture

相關工具

用這些工具一起完成：產生 schema、驗證 payload、產生 mock 資料與建立強型別模型。

Mock 產生器

依 schema 產生更真實的範例 JSON，用於測試、Demo 與原型。

JSON Schema 產生器

由 JSON 樣本產生基礎 schema，再補齊限制以符合正式需求。

JSON Schema 驗證器

在迭代契約時，用 schema 驗證 JSON payload。

JSON 格式化

在產生 schema 或 mock 前先把 JSON 美化並規範化。

JSON 驗證

先檢查 JSON 語法並定位錯誤，再進行 schema/mock 流程。

JSON 轉 TypeScript Types

以穩定範例產生 TypeScript 介面，維持資料模型一致。

常見問題

什麼是 JSON Schema 範本？

JSON Schema 範本是常見資料結構（例如使用者資料、商品、API 回應等）的預設 Schema，適合作為你自訂 Schema 的起點，也能用來產生 Mock 資料。

我可以怎麼使用這些 Schema？

你可以檢視、複製或下載範本 Schema，並在 Mock 產生器中直接產生範例資料，或在 Schema 驗證器中用它驗證真實 payload。

複雜度等級代表什麼？

簡單：欄位少、巢狀淺；中等：包含巢狀物件與陣列；複雜：巢狀更深、關聯更多、constraints 更完整。

可以修改這些範本嗎？

範本本身是唯讀，但你可以複製/下載後再修改 JSON Schema，以符合你的實際需求。

如何搜尋想要的 Schema？

使用搜尋框依名稱、描述、tags 或 use case 查找，並搭配分類、複雜度與 tags 進一步縮小範圍。

有哪些分類？

資料庫包含使用者管理、電商、API、設定、金融、社群等分類，每個分類下都有對應情境的 Schema。

如何從範本產生 Mock 資料？

點擊範本上的「產生」即可開啟已預填 Schema 的 Mock 產生器；再設定筆數與參數，即可快速產出更真實的範例資料。

這些範本相容哪些 JSON Schema Draft？

範本以實用性為主，遵循常見且相容性高的 JSON Schema 約定，並不嚴格綁定某個 Draft；如你的工具鏈需要更嚴格版本，請自行調整。

如何快速找到適合的範本？

先用搜尋框匹配名稱/描述/tags/use case，再搭配分類與複雜度篩選，最後按名稱/分類/複雜度/最新排序微調。

Schema 資料庫 | JSONSwiss