Swagger - 将urtag标签添加到url端点

Question

我正在使用swagger记录java restful api。这个api有两个端点，只在查询字符串中有所不同。

GET /resources?id=:id

和

GET /resources?name=:name

由于两个端点共享相同的路径和方法，因此swagger ui仅显示一个端点。

我知道swagger目前不支持此功能。但是，我知道可以使用url hastag #来欺骗/解决它：

https://github.com/OAI/OpenAPI-Specification/issues/182#issuecomment-164037595

如果假设我的方法是：

，我怎么做才能告诉我我的端点可以有一个可选的#param

     @RequestMapping(method = RequestMethod.GET, params = {"name"})
     public ResponseEntity findResourcesByName(@RequestParam(value = "name") String name) {
         ....
     }

这可能吗？