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



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

Swagger规范知道info.version字段,但是在pathsparameters上,我找不到参考此版本的东西。

也许以x-...(例如x-since)开头的供应商扩展名可能会有所帮助。至少使用它们不会失败。

但是,该用例是否有任何现有的实现?

我不知道OpenAPI/Swagger 2.0规格中的任何现有属性以满足您的需求,因此您应该使用供应商扩展名(X-Since,X-Since,X-created-On,x-创建等)

最新更新