SwaggerHub 是 Swagger API 的一个集成服务网站,提供 Swagger 的企业级服务需求,测试下来对接口服务的需求满足度非常之高,可以非常放心的使用,而且颜值足够高
Swagger 的创始人 Tony Tam 在2015年加盟 SmartBear Software 任 VP,并将 Swagger 相关的企业级服务都带到了 SmartBear,所以 SwaggerHub 也可以说是一个官方维护性质的 Swagger API 站点,质量颇有保障
在配置完 Swagger 的 YAML 文件之后,可以再搭配一个 SmartBear 家的 VirtServer 服务,就可以完美的实现文档+数据Mock,给予项目极高的 API 接口服务解决方案,这里是配置说明:
https://swaggerhub.com/help/integrations/smartbear-virtserver
母公司 SmartBear 是一家专业做技术服务产品的公司,旗下产品颇多,有10几款各式产品,官方的自我介绍:
Software powers the world. At SmartBear, we know that for every application, there is a software team working hard behind the scenes to keep users happy. We create the software tools that development, testing, and operations teams use to deliver the highest quality and best performing software possible, shipped at seemingly impossible velocities. With products for code review, API and UI level testing, and monitoring across mobile, web and desktop applications, we equip every member of your team with tools to ensure quality at every stage of the software cycle.
SwaggerHub 提供的帮助文档,对网站所提供的功能有详细的介绍(同时也是对 Swagger 使用的丰富介绍,提供的例子非常直观):
https://swaggerhub.com/help/index
在使用 SwaggerHub 做的接口文档的时候,直接从 Url 访问一个接口会报错:
{"message":"Missing matching response for specified Accept header"}
其实这个问题非常的有问题,在官方提交了 BUG 看是不是一个 feature,解决的办法是在把 header 中的 Accept 修改为:
Accept: application/json
如果在浏览器里面:设置的方法可以是在 chrome 里面装 ModHeader 插件(需要配置好 Filter)
如果在 Postman 里面:直接添加 Header 的值(可以在 Presets 里面设置好,方便使用)
SwaggerHub 可以设置集成 Github OAuth,一键将 Swagger 发布到 Github,也是蛮方便的