OpenAPI 规范(以前称为 Swagger 规范)已成为全球定义 RESTful API 的标准。在 API 开发中使用 OAS 时,出现了两种重要的思想流派:“设计优先”和“代码优先”的 API 开发方法。
设计优先方法提倡在编写任何代码之前首先设计 API 的合同,这是一种相当新的方法,但正在迅速被 API 团队采用。在设计优先方法中,团队能够充分利用 OAS 的强大功能,将 API 定义用作 API 开发的真实来源,并利用该定义自动生成源代码、文档、测试用例,甚至 API 的监视器。
在本网络研讨会中,我们将研究 OAS 设计优先方法的优势,并研究团队如何利用最新版本的 OpenAPI 规范 (OAS 3.0) 和 Swagger 工具来采用设计优先方法。
我们将涵盖
- 了解 OAS 的不同方法
- 转向设计优先方法的步骤
- 实施审查流程,以获取内部利益相关者的反馈
- 通过 OAS 3.0 代码生成从设计过渡到开发
- 通过 SwaggerHub 和源代码控制同步使设计和开发保持同步
立即将这些策略付诸实践。 免费开始使用 SwaggerHub。