Swagger/OpenAPI 如何将有关版本的信息添加到架构中?

Swagger/OpenAPI How to add infomation about version to schemas?

提问人:tomasz-mer 提问时间:11/14/2023 最后编辑:tomasz-mer 更新时间:11/16/2023 访问量:21

问:

我有一个接口,其中包含两个同名的实现。两种实现都有指定版本(v1、v2...)的注释如何在OpenAPI中正确建模?

interface TestIf {}

@Version(version = "1")
class TestImpl implements TestIf { }

@Version(version = "2")
class TestImpl implements TestIf { }

我在这里遇到了类似的东西,但我不知道是否正确。

"TestIf":{
            "type":"object",
            "oneOf":[
               {
                  "$ref":"#/components/schemas/TestImpl_1"
               },
               {
                  "$ref":"#/components/schemas/TestImpl_2"
               }
            ]
         }

这是个好主意吗?

Swagger OpenAPI

评论


答: 暂无答案