Swagger-UI响应内容类型

Question

是否可以在不创建响应类（状态200）架构的情况下添加“响应内容类型”选择框？

我的Web服务根据accept标头返回JSON或XML格式。之后我需要这个下拉列表。

Answer 1

您可以使用Swagger定义的produces属性填充“响应内容类型”下拉列表的值：

---
swagger: '2.0'
info:
  version: 0.0.0
  title: Simple API
produces:
  - application/xml
  - application/json
paths:
  /:
    get:
      responses:
        200:
          description: OK

您最终还需要定义响应模式，但该定义可以独立于响应内容类型（json vs xml）。