swagger - 具有相同名称的多个响应类

Question

我正在使用一个swagger API，并且有两个名称相同但名称空间不同的类 - foo.Profile和bar.Profile。

架构最终看起来像这样（修剪为重要部分）。请注意，两个端点都表示它们返回#/definitions/Profile，但该定义适用于foo.Profile。 bar.Profile的定义不存在

{
    "paths":{
        "/v1/project-data/profiles":{
            "get":{
                "responses":{
                    "200":{
                        "schema":{
                            "$ref":"#/definitions/Profile"
                        }
                    }
                }
            }
        },
        "/v1/apc/profiles":{
            "get":{
                "responses":{
                    "200":{
                        "schema":{
                            "$ref":"#/definitions/Profile"
                        }
                    }
                }
            }
        }
    },
    "definitions":{
        "Profile":{
            "description":"Java type: foo.Profile",
            "properties":{
                ...
            }
        },
    }
}

有没有办法让swagger为这两个类提供单独的定义，因此响应模式可以正确地传达给用户？

可以将类名更改为不同，但不可取。它们已经被命名为逻辑组，因此将它们称为Profile以外的其他东西会很尴尬。

我使用这些版本，并且无法更改它们，因为这必须集成到更大的项目中：

• Java 1.8
• Restlet 2.3.5
• Swagger Wordnik 1.5.3