OpenAPI / Swagger 檢視器

把 OpenAPI 3.0 / 3.1 或 Swagger 2.0 文件(YAML 或 JSON)渲染成可瀏覽的 API 參考 — 資訊、伺服器、按標籤分組的路徑、引數、由模式生成的請求體示例、響應與安全。展開任意操作即可試調,從瀏覽器發出真實請求,或匯出為 cURL。文件在本地解析;遠端 $ref 目標與外部模式不會被抓取(完全本地)。更想要互動式請求編排?請看 REST API 客戶端 / 測試器與全部 API 工具 家族。
試調
引數
關於本檢視器:支援 Swagger 2.0 與 OpenAPI 3.0 / 3.1。引用只在文件內部解析(#/components/schemas/…、#/definitions/…);外部檔案 / URL 引用會被報告而不是抓取。試調呼叫取決於目標伺服器的 CORS 策略 — 若呼叫被阻止,請用 cURL 轉換器或 REST 客戶端在瀏覽器沙箱之外執行。
OpenAPI 與 Swagger、v2 與 v3

Swagger 是最初的工具名;2015 年規範格式被捐給 Linux 基金會後改名 OpenAPI,Swagger 作為工具品牌延續下來。一份文件由 info(後設資料)、paths(每個端點的操作)和 components(可複用的模式)構成。

版本鍵告訴檢視器該用哪個解析器:swagger: "2.0" 與 openapi: 3.0.x — v3 把請求體從引數中移出,並採用了真正的 JSON Schema。