Swagger $ref http 响应

Question

我是 Swagger 的新手，正在研究 API 创建通用 HTTP 响应代码的操作：-

• '401: 未经授权

• '403': 禁止

• '404': 未找到
• '500': : 内部服务器错误

我尝试 $ref: #/definitions/responses 定义响应，但出现错误。有没有办法做到这一点？，以避免每次操作后出现冗余代码块。非常感谢任何帮助。

提前致谢

Answer 1

已找到答案，

这可以用来引用来自其他文件的一般响应（在我的例子中）。也可以从文件中引用。

 '400':
      $ref: _http-responses.yaml#/400
    '401':
      $ref: _http-responses.yaml#/401
    '403':
      $ref: _http-responses.yaml#/403
    '404':
      $ref: _http-responses.yaml#/404
    '500':
      $ref: _http-responses.yaml#/500

我创造了

_http_responses.yaml

然后引用了它。