使用swagger 2.0记录REST API时,如何使实现和文档保持同步?

时间:2015-06-18 14:39:10

标签: swagger-2.0

我想使用Swagger 2.0来记录REST API,因为它似乎被广泛用于记录RET API。

但是,我不确定如何将文档和实现保持同步?例如当我添加新的API时,我必须确保API文档中使用的模型(表示Response)应该与REST实现中创建的模型相同。同样,文档中给出的资源名称应与实现中的资源名称匹配。

有没有办法从swagger 2.0规范生成的文档中生成资源接口和模型类?

1 个答案:

答案 0 :(得分:-2)

您可以使用这些工具生成服务器源(它们也可以生成客户端源):