swagger - Swagger-UI 响应内容类型

Question

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

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

Answer 1

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

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

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