如何在Swagger YAML中创建嵌入对象？

Question

我想添加一个HAL资源链接到一个定义，

definitions 
    HalItemResponse: 
    name: 
     type: string 

添加什么

"_links": { 
"self": string, 
"filter": string 
} 

如何？

Answer 1

无论你想要使用定义，通常在请求或响应中，你都会像这样引用它。

JSON

{ 
    halitem: { $ref: '#/defintions/HalItemResponse' } 
} 

YAML

halitem: 
    $ref: '#/definitions/HalItemResponse' 

非常相似，设置类型，而是指向定义架构。