如何用 swagger 引用响应对象？

Question

我可以这样做：

parameters:
  avatarSizeParam:
    name: size
    in: query
    description: Size of avatar.
    enum: [32, 64]
    required: false
    type: integer
    format: int32

paths:
  /my/path/avatar:
    get:
      parameters:
        - $ref: '#/parameters/avatarSizeParam'

responses:
  notFoundResponse:
    description: Entity not found.
    schema:
      $ref: '#/definitions/schema404'

paths:
  /my/path/avatar:
    get:
      parameters:
        - $ref: '#/parameters/avatarSizeParam'
      responses:
        - $ref: '#/responses/notFound'

然而，这似乎不起作用。我返回到操作对象的规范，注意到参数可以是引用对象，但响应不能。

如果您无法引用响应定义对象（最顶层的响应）中的项，那么允许该对象的意义何在？有没有办法做到这一点？

Answer 1

如果您在这里看到，您必须将HTTP状态代码定义为密钥，那么正确的语法是：

paths:
  /my/path/avatar:
    get:
      parameters:
        - $ref: '#/parameters/avatarSizeParam'
      responses:
        404:
          $ref: '#/responses/notFound'