我有一个基于npm
的项目,我想在其中引入基于swagger
的REST API客户端。我的想法是拥有API描述yaml
文件并在构建步骤中生成客户端。
有没有很好的方法来做到这一点?我发现只有swagger-js-codegen
,但我不清楚如何将其整合到构建过程中。
答案 0 :(得分:2)
鉴于您在Swagger / OpenAPI规范中记录了您的REST API,您可以简单地使用curl
(或其他http工具)发送HTTP请求以生成API客户端作为构建的一部分处理。为http://petstore.swagger.io/v2/swagger.json
生成ruby客户端的curl请求示例如下:
curl -X POST -H "content-type:application/json" -d '{"swaggerUrl":"http://petstore.swagger.io/v2/swagger.json"}' https://generator.swagger.io/api/gen/clients/ruby
有关详细信息,请参阅https://github.com/swagger-api/swagger-codegen#online-generators。