如何在API中定义,从哪个版本开始支持path/parameter
How to define in an API, since which version a path/parameter is supported
我们越来越自信 API/openAPI 并且为了记录更改,我们喜欢记录路径或参数(可能还有定义),因为 API 哪个版本可用。
swagger 规范知道 info.version
字段,但在 paths
或 parameters
上我找不到引用此版本的内容。
也许 vendor extensions 以 x-...
开头,例如 x-since
可能会有帮助。至少使用它们验证不会失败。
但是这个用例可能有任何现有的实现吗?
我不知道 OpenAPI/Swagger 2.0 规范中有任何现有属性可以满足您的需求,因此您应该使用供应商扩展(x-since、x-created-on、x-created-by、等等)
我们越来越自信 API/openAPI 并且为了记录更改,我们喜欢记录路径或参数(可能还有定义),因为 API 哪个版本可用。
swagger 规范知道 info.version
字段,但在 paths
或 parameters
上我找不到引用此版本的内容。
也许 vendor extensions 以 x-...
开头,例如 x-since
可能会有帮助。至少使用它们验证不会失败。
但是这个用例可能有任何现有的实现吗?
我不知道 OpenAPI/Swagger 2.0 规范中有任何现有属性可以满足您的需求,因此您应该使用供应商扩展(x-since、x-created-on、x-created-by、等等)