定义可以重复使用的多条路径与扬鞭

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解决了所有问题。这只是架构验证发生的副作用，导致非描述性错误被抛弃。