SwaggerHub

SwaggerHub 在本地 Swagger Editor 开源工具基础上提供团队协作能力。核心功能包括：可视化 OpenAPI 3.x 与 Swagger 2.0 编辑器、内置 Mock 服务器自动根据接口定义返回示例数据、SDK 代码生成器（支持 Java、Python、Node.js 等多语言）、自动托管 API 文档门户。免费版 Editor 仅支持单人本地编辑，无版本控制、无团队权限管理、无托管文档站，团队使用需要订阅团队版。

SwaggerHub 提供三档订阅：免费版支持 1 名用户和 1 个私有 API，适合个人学习尝鲜；团队版按席位计费（约每用户每月 53-77 美元，年度订阅），包含 Git 集成、域名定制、审计日志，适合 5-50 人规模的研发团队；企业版为私有化部署，提供 SSO、专属支持、无限 API 数量，适合金融、政企等对数据合规要求严格的中大型组织。可通过 SmartBear 销售获取报价。

Postman 强项在 API 测试和调试，SwaggerHub 强项在设计优先（Design-First）流程。SwaggerHub 提供原生 OpenAPI 规范校验、Visual Studio Code 插件、Git 仓库双向同步，可在代码编写前完成契约评审。Postman Collection 虽可导出 OpenAPI，但本身不是规范编辑器。Stoplight 则在文档门户美观度上更强，但 SwaggerHub 与 SmartBear 产品链（ReadyAPI、Collaborator）打通更紧密，适合已有 SmartBear 工具栈的企业。

SaaS 模式可直接通过 swaggerhub.com 注册使用，数据托管在 AWS 美国东部机房，支持区域选择。企业版提供 On-Premise 私有化部署，需在客户自有 Kubernetes 或 Docker 环境中安装，最少 3 节点集群配置（建议 8 核 32GB）。实施周期通常 2-4 周，SmartBear 提供部署文档、迁移工具和实施服务，确保企业内网与 LDAP/Active Directory 集成，符合 GDPR、等保等合规要求。

SwaggerHub 支持通过 Git 仓库（GitHub、GitLab、Bitbucket）双向同步 OpenAPI 定义文件，团队可在熟悉的 IDE 中编辑后推送。也提供 REST API 与 CLI 工具（swaggerhub-cli），可在 Jenkins、GitHub Actions 中执行规范校验（lint）、生成 SDK、运行契约测试（与 Pact 集成）。Integrations 模块还支持 Slack 通知、Jira 工单关联、Webhook 触发下游流程，使 API 规范成为流水线的单一事实来源。