如何在API中定义,因为支持哪个版本的路径/参数

时间:2016-06-23 12:05:39

标签: swagger openapi

我们有一个不断增长的swagger API / openAPI,并且用于记录我们想要在路径或参数(可能是定义)上记录的更改,因为它可以使用哪个版本的API。

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

以“x-... x-since开头的vendor extensions可能会有所帮助。至少验证不会失败使用它们。

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

1 个答案:

答案 0 :(得分:1)

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