我们有一个不断增长的Swagger API/OpenAPI,用于记录我们想在路径或参数(也许是定义)上记录的更改(也许是定义),因为它可以使用API的哪个版本。
Swagger规范知道info.version
字段,但是在paths
或parameters
上,我找不到参考此版本的东西。
也许以x-...
(例如x-since
)开头的供应商扩展名可能会有所帮助。至少使用它们不会失败。
但是,该用例是否有任何现有的实现?
我不知道OpenAPI/Swagger 2.0规格中的任何现有属性以满足您的需求,因此您应该使用供应商扩展名(X-Since,X-Since,X-created-On,x-创建等)