是否可以定义可重用的路径操作？

Question

我们正在为我们的Swagger API添加CORS支持，其中包括定义每个路径的选项操作。由于这是一组样板代码，我们要在定义，一旦定义选项操作部分，像这样

"definitions":{ 
"CORS":{ .. } 
} 

然后引用运行在我们的道路，像这样

"paths":{ 
     "/system/info":{ 
     "options" : { 
      "$ref": "#/definitions/CORS" 
     } 
    } 
} 

这似乎没有不当我们上传swagger定义时工作。什么是实现我们定义路径操作一次然后重新跨路径使用它的目标的正确方法？

Answer 1

您可以参考整个路径到外部位置：

"paths": { 
    "/system/info": { 
    "$ref": "cors.json" 
    } 
} 

但不是一个单独的HTTP方法。此外，规范不允许为路径提供相对引用 - 您必须将其放在单独的文档中。

有关路径项目对象的信息，请参阅here，关于顶级悬挂对象的请参阅here。