如何在API中定义,从哪个版本开始支持path/parameter

How to define in an API, since which version a path/parameter is supported

我们越来越自信 API/openAPI 并且为了记录更改,我们喜欢记录路径或参数(可能还有定义),因为 API 哪个版本可用。

swagger 规范知道 info.version 字段,但在 pathsparameters 上我找不到引用此版本的内容。

也许 vendor extensionsx-... 开头,例如 x-since 可能会有帮助。至少使用它们验证不会失败。

但是这个用例可能有任何现有的实现吗?

我不知道 OpenAPI/Swagger 2.0 规范中有任何现有属性可以满足您的需求,因此您应该使用供应商扩展(x-since、x-created-on、x-created-by、等等)