我熟悉 RESTful API,但是,我对 Swagger 和 Open API 不熟悉。我想澄清一下 openapi-generator-cli 等工具的作用以及如何充分利用这些工具。
使用OpenAPI的最新规范,很清楚如何设计 API。例如,我可以在 .yml 文件中编写我的 api。就我而言,我使用 Java 和 SpringBoot 作为我的语言,并且我有兴趣使用open-generator-cli从 .yml 文件创建服务器存根。
然后我可以将浏览器指向http://localhost:8080/swagger-ui.html#/。除了提供显示端点、参数、模型、响应和 curl 请求的漂亮文档之外,服务器存根还提供了哪些其他值?获取服务器代码并将其改编为生产代码库是否常见?然后随着 API 的变化,整个步骤可以更容易地重复吗?