跳至內容
Schema 工具

JSON 轉 OpenAPI Schema

貼上 JSON 就能產生 OpenAPI 的元件 schema。
物件與陣列會轉為含必填欄位的 JSON Schema,混合的陣列則以 oneOf 表示。
所有處理都在瀏覽器完成,不會將資料傳送到伺服器。

指南: 使用方式與特色

  • 將 JSON 貼入輸入框後點擊「轉換成 OpenAPI」。
  • 物件會展開為帶 properties 與 required 的 JSON Schema。
  • 陣列會推斷元素型別;若混合多種型別則使用 oneOf。
  • 可使用複製或清除按鈕來重複利用或重新開始。

範例: 輸入與輸出範例

Infer schema from a profile object

輸入範例

{"name":"Jane","email":"[email protected]","verified":true}

輸出範例

{
  "type": "object",
  "properties": {
    "name": {"type": "string"},
    "email": {"type": "string", "format": "email"},
    "verified": {"type": "boolean"}
  },
  "required": ["name", "email", "verified"]
}

FAQ: 常見問題

  • 輸出長什麼樣子?

    會建立 components.schemas.Root,並以 JSON Schema 方式包含 properties 與 required。
  • 混合陣列或 null 會如何處理?

    會推斷每個元素,若有多種類型則使用 oneOf,null 則以 nullable: true 表示。
  • 資料會被送到伺服器嗎?

    不會。所有運算都在瀏覽器完成,沒有網路請求。

使用情境: 常見的使用情境

  • Drafting schemas

    Transform JSON samples into OpenAPI schema stubs to seed documentation or mock generation.

  • Sharing endpoint expectations fast

    Convert request/response examples and paste them into PRs or issues to align on contract details.

  • Checking consistency with existing specs

    Compare generated stubs with current definitions to spot fields that need updates.

注意: 注意事項與限制

  • 處理皆在瀏覽器內完成

    輸入與輸出都留在你的裝置,關閉分頁或清除快取時,暫存狀態會被移除。

  • 關鍵資料請再次確認

    結果僅供輔助,放到正式系統或對外分享前請先檢查並依需求驗證。

  • 大型資料仰賴裝置性能

    非常大的文字或檔案在部分瀏覽器可能較慢,建議重度工作時使用桌面環境。

JSON 轉 OpenAPI Schema 產生器

將 JSON 範例轉成 OpenAPI schema,用於 request、response 與 components.schemas 文件化。可以快速建立 schema 初稿,減少手動撰寫每個 property 的時間。

適合使用的情境

  • 文件化 endpoint:從實際回應開始建立 schema。
  • 整理 API 合約:檢查型別、required 欄位與巢狀結構。
  • 準備 Swagger 文件:快速產生 OpenAPI schema 草稿。

format、enum、optional field、array 限制等細節仍需要人工確認。

這個工具的相關文章

最新文章

使用案例
2026-08-07

curl 選項速查|-X、-H、-d 實際做了什麼與常見陷阱

整理實務上會遇到的 curl 選項:為什麼加了 -d 就已經是 POST、-d 與 --data-raw 的差別、開頭的 @ 會悄悄讀取檔案的陷阱、單引號與雙引號的取捨,以及為什麼 -k 和 -L 值得多想一下。

工具介紹
2026-08-06

JSON Schema 與 Zod 雙向轉換的原理|required 與 .optional() 的對應

解析雙向轉換器的實作:把 JSON Schema 轉成 Zod 結構定義,也把 Zod 程式碼轉回 JSON Schema。內容涵蓋 required 與 .optional() 預設值相反的陷阱、限制條件對照表,以及不執行程式碼就完成剖析的做法。

使用案例
2026-08-06

SQL 子句執行順序參考|為什麼 WHERE 看不到 SELECT 的別名

SQL 並不是照您撰寫的順序執行。以邏輯執行順序(FROM → WHERE → GROUP BY → HAVING → SELECT → ORDER BY → LIMIT)為主軸,說明別名為何在 WHERE 無法使用、WHERE 與 HAVING 的分工、ONLY_FULL_GROUP_BY、COUNT(*) 與 COUNT(欄位) 的差異,以及 LEFT JOIN 搭配 WHERE 的陷阱。

使用案例
2026-08-06

unified diff 格式閱讀指南|看懂 git diff 的 @@ 標頭

說明如何閱讀 git 產生的 unified diff 格式:@@ -12,7 +12,9 @@ 四個數字的意義、只改一個字元為何顯示成整行替換、空白與換行字元的陷阱、\ No newline at end of file、合併提交的 @@@ 組合式 diff,以及以 similarity index 推斷檔案更名。

使用案例
2026-08-06

UTC⇄JST 換算參考手冊|9小時時差對照表與時區踩雷指南

以對照表整理 UTC 與日本時間(JST)的換算,並說明與台灣時間(UTC+8)相差 1 小時的關係。內容涵蓋 ISO 8601 的 Z 與 +09:00、JavaScript 日期解析悄悄位移 9 小時的條件、MySQL/PostgreSQL 的時區行為,以及 GitHub Actions cron 一律以 UTC 執行的陷阱。

使用案例
2026-08-04

CREATE TABLE 參考手冊|MySQL、PostgreSQL、SQLite 的型別與約束差異

以跨資料庫對照表整理 CREATE TABLE(DDL)的寫法:型別對應表、自動編號(AUTO_INCREMENT / IDENTITY / rowid)的方言差異、外鍵的 ON DELETE 行為,以及 MySQL 會靜默忽略的 CHECK 約束。

廣告

廣告