是否可以定義可重用的路徑操作？

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。