Swaggerhub

1、使API开发变得快速而简单

SwaggerHub是一个集成的API设计和文档平台，专为团队打造，以推动整个API开发工作流程的一致性和纪律性。

2、更快更标准化的API设计

使用完全符合 新Swagger (OpenAPI)标准的功能强大的编辑器，加速您团队的设计过程，而不会降低质量或组织风格的一致性。

（1）API设计的灵活开发人员选项
SwaggerHub为VS Code和IntelliJ IDEA提供原生插件。这两个IDE扩展都使API设计人员能够直接从他们 喜欢的开发人员环境中查看和编辑他们的API和域。我们的目标是通过满足您工作地点的选项并提高您的工作效率，使API设计变得快速和简单。
（2）强大的OAS设计编辑器
在一个直观的、基于浏览器的编辑器中设计新的和现有的API，该编辑器专为Swagger/OpenAPI合约的快速迭代而构建。动态验证和保存您的设计，为设计API提供无忧的编辑体验， 大限度地提高消费者的采用率。
（3）设置和执行风格指南
通过内置的API标准化确保您的所有API都符合您的组织设计标准。您的开发人员不再需要参考wiki页面、GitHub文档或PDF来保持API之间的样式一致性。
 
3、安全的API协作

将您的API设计和开发集中在一个位置，让您的团队能够在新API上无缝协作，或在集中式平台上发现现有API。

（1）更好的团队协作
SwaggerHub是为组织构建的，允许您集中管理您的API合同、文档和团队。设置团队协作设计和构建您的API，无需担心安全性和扩展性。
（2）沟通和跟踪问题
通过SwaggerHub评论共同探讨新想法、突出问题并解决它们。SwaggerHub评论也可用作票务系统，这意味着您始终可以跟踪未解决的问题和对话，以相应地解决问题并确定优先级。
（3）标准化您的API流程
消除跨多个开发平台跟踪来自不同团队成员的更新的麻烦。为开发人员提供他们想要的独立性，并为架构师提供他们跟踪更改并在进行更新时得到通知所需的监督。
（4）集成到您的API生命周期中
从跨源代码控制主机（如GitHub、GitLab和Bitbucket）的无缝同步，到API部署到APIM平台（如AWS、Azure和IBM）以及使用自定义webhook的外部构建触发器，SwaggerHub专为组织设计，以将其API开发提升到一个新的水平。

4、促进API生命周期

一个内部存储库，用于托管您的API并集成到您的团队信任的工具中以提供出色的API

（1）主机API定义
SwaggerHub充当托管和发现API定义的事实来源。在内部存储库中托管API定义，并根据团队、项目或其他架构考虑组织API。
（2）管理API版本
对RESTful服务的更改是不可避免的，促进现有API的版本控制可能是一个容易出错的过程。SwaggerHub让您可以不断更新和发布API的新版本，以便您的消费者可以在正确的时间访问正确的版本。
（3）改善监督和治理
随着API的发展和变化，让利益相关者保持一致很重要。SwaggerHub为API架构师和团队领导提供必要的监督，以跟踪更改、解决问题并标准化内部开发API的方式。
（4）集成到您的API生命周期中
设计和文档只是更大的API生命周期的一部分，而SwaggerHub专注于它们，我们还使团队能够无缝地连接到其他外部软件解决方案。无论您是部署到API网关、与服务器端代码存储库同步，还是连接到测试工具，SwaggerHub都能完美地融入您现有的工作流程。
 

5、托管的交互式API文档

自动生成安全托管且完全交互的API文档

（1）专业的记录
SwaggerHub将您的API合同可视化地呈现为一个完全交互式的文档，以实现实时可操作性，让您的 终消费者在将其集成到他们的代码之前确切地知道您的API将如何工作和表现。
（2）自动生成OAS文档
希望快速开始使用SwaggerHub中的OAS记录您的API？利用集成的Swagger Inspector从您现有的API生成OAS文档。在不到3个步骤中，您将在SwaggerHub中生成并托管 OAS 定义。
（3）导入和托管API文档
从Web或本地文件系统导入现有的基于OAS的API以获取其他文档。API定义及其文档在导入时完全导入云中，允许您的团队向API添加丰富的内容和资源。
（4）在安全环境中管理访问
API文档仅在API使用者可以访问您的文档并获得使用API所需的信息时才有用。SwaggerHub允许您在云中托管API文档，并通过内置的权限控制和与API网关的集成安全地提供访问。