我正在为嵌套资源(属于交付的内容)定义路径。如果客户端收到404,则可能是因为找不到传递ID,或者传递不包含任何指定类型的内容。
如何使用OpenAPI(YAML)建立模型?
我现在有这个...
paths:
'/deliveries/{id}/content/articles':
get:
summary: Retrieves articles from a delivery
description: Retrieves all articles from a single delivery
[...]
responses:
'200':
description: articles found
schema:
$ref: '#/definitions/Article'
'404':
description: delivery not found
schema:
$ref: '#/definitions/Error'
'404':
description: delivery did not contain any articles
schema:
$ref: '#/definitions/Error'
Run Code Online (Sandbox Code Playgroud)
...但是当我从Swagger编辑器中保存JSON时,它将删除所有404响应(最后一个响应除外)(“交付内容不包含任何文章”)。