跳至內容
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":"jane@example.com","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 限制等細節仍需要人工確認。

這個工具的相關文章

Recent Articles

使用案例
2026-08-04

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

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

工具介紹
2026-08-03

從資料表設計自動產生 CREATE TABLE 語句的原理|DDL 產生器

解析 DDL 產生器的實作:以視覺化方式設計資料表並產生 CREATE TABLE 語句與 ER 圖。內容涵蓋 MySQL/PostgreSQL/SQLite 的型別轉換規則,以及從 JSON 範例推論欄位的演算法。

使用案例
2026-07-21

GitHub Actions needs 設計模式集|加速 CI 的依賴關係組織法與反模式

以模式與反模式對照表整理 GitHub Actions 中 needs 所建立的 job 依賴關係。涵蓋 concurrency 取消重複執行、fail-fast 取捨、matrix 與 needs 組合的陷阱,以及可重複使用工作流程,並附上可直接複製的 YAML 範例。

使用案例
2026-07-21

Mermaid ER 圖語法完全參考|關聯符號與實戰範例

完整整理 Mermaid erDiagram 語法:烏鴉腳表示法的基數對照表、一對多與多對多的差異、含 PK/FK 的屬性定義,以及一個完整的電商範例。

工具介紹
2026-07-21

如何用 SQL 建構器以視覺化方式組出 SELECT、JOIN 查詢

說明如何在瀏覽器中用視覺化 SQL 建構器組合 SELECT、WHERE、JOIN。涵蓋數值自動加引號的判斷原理、JOIN 使用時機對照表,以及多資料表 JOIN 的寫法。

使用案例
2026-07-21

SQL JOIN 完全參考|INNER、LEFT、RIGHT、FULL 的差異與結果列數觀念

以對照表與結果列數範例,完整整理 SQL 的 JOIN 種類(INNER/LEFT/RIGHT/FULL/CROSS/SELF)。說明一對多 JOIN 為何會使列數增加、WHERE 子句與 ON 子句在 NULL 判斷上的陷阱,以及多資料表 JOIN 的寫法。

廣告

廣告