Code First 方法是构建 API 的一种更传统的方法,在制定业务需求之后进行代码开发,最终从代码生成文档。Design First 方法提倡在编写任何代码之前先设计 API 的契约。这是一种相对较新的方法,但很快就会流行起来,尤其是在使用 OpenAPI 规范格式的情况下。
- 设计优先:计划被转换为人类和机器可读的合约 (API),例如 Swagger 文档,从中构建代码
- Code First:根据业务计划,直接对API进行编码,从中可以生成人类或机器可读的文档,例如Swagger文档
系统开发周期
这两种方法各有优缺点,归根结底,选择正确的方法归结为您希望通过 API 解决的直接技术和战略需求。让我们深入探讨何时以及为何选择“设计优