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。