Swagger
SmartBear 维护的 API 全流程工具套件,围绕 OpenAPI 提供可视化编辑、Mock 服务与契约测试,适合多个团队共同维护一批 API 时卡住破坏性变更。
5 次可以打开平均 1.7 秒
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。Swagger 是 SmartBear 维护的一套 API 全流程工具,围绕 OpenAPI 规范展开:先写接口描述,再生成文档和 Mock 服务,最后用契约测试验证接口有没有被改坏。它面向的是要长期维护一批 API 的团队,不是写一两个接口的个人项目。
主要功能
Studio 是编辑和治理接口的地方,提供可视化编辑器,不写代码也能改接口定义;接口描述集中放在一个目录里,方便复用和检索,评审时可以直接在描述上留评论。它同时支持 OpenAPI 和 AsyncAPI,内置模板和风格检查,能按团队规范自动 lint。设计完成后可以导出多种格式,也能一键生成 Mock 服务器,让前端先对着假接口开发。
Portal 把接口描述变成对外文档站,可以自定义品牌、控制公开还是仅授权可见,按角色分配编辑和查看权限,渲染方式可选 Swagger UI 或 markdown 风格。Contract Testing 则在开发阶段校验消费方与提供方的契约,支持 HTTP、Kafka 等协议,并提供 can-i-deploy 判断某个组件是否可以发布。
适合谁
适合有多个团队共同维护 API 的公司:后端负责定义接口,前端和外部开发者通过门户查文档,测试用契约测试卡住破坏性变更。个人开发者如果只是想写一份 OpenAPI 文件,用免费的 Swagger Editor 就够了,不必上整套产品。
费用与限制
官网提供免费试用入口,具体套餐和价格需要到定价页查看,页面上只列了关于计费方式的常见问题,没有直接给出数字。界面为英文,登录入口在 app.swaggerhub.com。AI 辅助生成、MCP server 创建等功能属于商业产品的一部分,是否包含在各档套餐里,材料没有说明。
