基于路径参数的备用 API 响应模式的 OPENAPI 3 JSON 结构是什么

Question

对于如何针对以下情况编写 json API 文档，我有点困惑：

对于我们的 GET，我们希望有一个路径参数，它允许“摘要”响应模式或“详细”响应模式。 我在某些地方看到过您可以使用 oneOf 以某种方式指定两个响应模式，并且我看到了一些基于内容类型的示例，但没有基于路径参数的示例。

所以我的 GET 路径定义是 /category/{format}

对于“摘要”的格式值，我的响应模式是：

"responses": {
      "200": {
        "description": "OK",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer"
                },
                "name": {
                  "type": "string"
                }
              }
            } ....

如果格式参数是详细的，则响应模式是：

"responses": {
      "200": {
        "description": "OK",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer"
                },
                "name": {
                  "type": "string"
                },
                "discription": {
                  "type": "string"
                },
                "subcategories": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      }   .....

有没有办法可以将这两个描述组合在同一个文件中？ 如果有怎么办？ 也许是一个简单的例子？