相关疑难解决方法(0)

如何在OpenAPI(Swagger)中指定多个404原因?

我正在为嵌套资源(属于交付的内容)定义路径。如果客户端收到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响应(最后一个响应除外)(“交付内容不包含任何文章”)。

swagger swagger-2.0 openapi

5
推荐指数
1
解决办法
2584
查看次数

标签 统计

openapi ×1

swagger ×1

swagger-2.0 ×1