API描述格式，如 OpenAPI （前身为Swagger Specification）、RAML和API Blueprint改变了团队对API文档的看法——提供了一种新的方式来描述API的行为和属性。近年来，OpenAPI（OAS）得到了最广泛的采用，并迅速成为REST API定义的行业标准。随着OAS的广泛采用，新的工具不断涌现，以帮助释放定义API的潜力。
使用OAS和Swagger构建卓越的API
Swagger是使用OAS开发API最广泛使用的工具生态系统。虽然Swagger这个名称经常与规范互换使用——但现在Swagger代表了一系列用于实现OAS的开源和专业工具。Swagger UI 是使用OAS记录API的最知名工具之一。使用Swagger UI（无论是开源版还是SwaggerHub平台内）— 您可以将OAS契约转换为交互式API控制台，消费者可以使用它与API交互并快速了解API的预期行为。可视化所有内部API，以便开发人员可以快速轻松地使用上游和下游服务。SwaggerUI内置了交互性，因此外部消费者也可以尝试API的每个资源，并在将其用于代码库之前熟悉它。除了生成文档，Swagger还支持使用Swagger Codegen为API生成实现代码和SDK。它还可以帮助您在SwaggerHub平台内部将您的API定义部署到流行的API网关，如AWS、IBM API Connect、Apigee和Microsoft Azure。
OAS和Swagger入门
虽然许多开发人员对于使用OAS从头设计一个全新的API感到得心应手，但为现有API生成OAS却相当具有挑战性。逆向工程规范不仅需要大量工作，还需要一个学习曲线来熟悉从现有已开发API生成OAS的过程。Swagger拥有多种工具来帮助完成此过程，包括用于从Java API创建OAS的流行Swagger Core项目，以及我们最新推出的在线工具Swagger Inspector，它可以从任何API端点自动生成OAS定义。在我们最新的白皮书：《记录您现有的API：使用OpenAPI & Swagger轻松制作API文档》中，我们介绍了Swagger Inspector，并探讨了使用OAS和Swagger入门的不同方法。我们涵盖了：
- API文档的重要性
- 使用OpenAPI规范（OAS）进行API文档
- 创建OAS的方法
- 使用Swagger工具为现有API生成OAS
- 在SwaggerHub中记录您的API
需要为现有API集生成OpenAPI定义？ 试试Swagger Inspector。希望标准化您的设计和文档流程？ 立即开始使用SwaggerHub。