在不同目录下使用 grails 上的 swaggydoc 记录 API 的多个版本,控制器名称相同
document multiple version of API using swaggydoc on grails with same controller name under separate directory
我在我的 grails 应用程序上使用 swaggydoc 插件来记录 REST APIs。我有两个版本的 API,v0 和 v1 以及具有相同名称的相应控制器,每个版本一个,例如:
directory structure
我有 Url 像 "/my2api/v1"(controller:"api",namespace:'v1')
"/myapi/v0" (controller:"api", namespace:'v0')
这样的映射
并将 API 端点的两个版本列为 /myapi/v0/activeContracts like here。
所以我的问题是,我怎样才能让 API 端点列出正确的 URL 以及相应的版本,如 /myapi/v0/activeContracts & /myapi/v1/activeContracts
正如我提到的我已经尝试过映射但它只会选择最后一个映射的第一个和将其分配给两个版本。
任何帮助将不胜感激。
对于面临相同问题的人,我找不到使用 swaggyDocs 的解决方案,并且还遇到了一些 post 建议它不支持 API 版本控制,所以最终切换到 Grails RestApiDoc 它提供了比我在 swaggyDocs 上所能获得的更多的控制(通过编辑 json 来更改 API conf)。但是,如果有人知道在 swaggyDoc 中解决这个问题的方法,请post。
我在我的 grails 应用程序上使用 swaggydoc 插件来记录 REST APIs。我有两个版本的 API,v0 和 v1 以及具有相同名称的相应控制器,每个版本一个,例如:
directory structure
我有 Url 像 "/my2api/v1"(controller:"api",namespace:'v1')
"/myapi/v0" (controller:"api", namespace:'v0')
这样的映射
并将 API 端点的两个版本列为 /myapi/v0/activeContracts like here。
所以我的问题是,我怎样才能让 API 端点列出正确的 URL 以及相应的版本,如 /myapi/v0/activeContracts & /myapi/v1/activeContracts
正如我提到的我已经尝试过映射但它只会选择最后一个映射的第一个和将其分配给两个版本。
任何帮助将不胜感激。
对于面临相同问题的人,我找不到使用 swaggyDocs 的解决方案,并且还遇到了一些 post 建议它不支持 API 版本控制,所以最终切换到 Grails RestApiDoc 它提供了比我在 swaggyDocs 上所能获得的更多的控制(通过编辑 json 来更改 API conf)。但是,如果有人知道在 swaggyDoc 中解决这个问题的方法,请post。