OpenAPI 预览

粘贴 OpenAPI 3 或 Swagger 2 文档(YAML 或 JSON)。Swagger UI 用内存中的 spec 本地渲染 — 正文不上传。

本页处理默认在浏览器本地完成,除非另有说明。

Try it out 会从你的浏览器直接请求 spec 中的 servers,不经过 Yaml Workbox。除非你要试调这些 API,否则请保持关闭。

正在加载 Swagger UI…

如何使用

  1. 粘贴 OpenAPI YAML/JSON,或载入 OpenAPI 模板。
  2. 点击「预览」(或开启较长防抖的实时转换)。
  3. 在下方浏览 paths。仅在需要发真实 HTTP 时再打开 Try it out。

常见问题

文档会上传吗?

不会。文档在浏览器解析后通过内存 spec 交给 Swagger UI,不会把正文拉到远程。

支持哪些版本?

OpenAPI 3.x 与 Swagger 2.0。根节点须含 openapi 或 swagger。

为何默认关闭 Try it out?

避免误调 servers 里的生产 API。需要试调时再手动开启。

相关工具