定義可以重複使用的多條路徑與揚鞭

Question

我有一系列的使用相同的路徑參數路徑共享路徑參數：

paths: 
    /catalog/items/{id}: 
    ... 
    /catalog/items/{id}/children: 
    ... 
    etc. 

我想{ID}參數是與描述和類型定義的一次，這樣我可以重新使用它，但是這似乎是無效的：

paths: 
    ... 
parameters: 
    catalogItemId: # <-- Not a valid parameter definition 
    name: id 
    in: path 
    description: The ID of the catalog item to update. 
    required: false 
    type: integer 
    format: int64 

它不似乎這應該根據編輯鏈接的模式是無效的（http://swagger.io/v2/schema.json# ），但由於某種原因被在線編輯拒絕。

是否有共享路徑參數定義？

Answer 1

發佈不久後，這個我意識到路徑參數被列爲

required: false 

路徑參數必須被要求揚鞭API定義。將其更改爲true解決了所有問題。這只是架構驗證發生的副作用，導致非描述性錯誤被拋棄。