Swagger 参数 oneof

在编写API文档时，Swagger是一种常用的工具。在Swagger中，参数（parameters）是用于传递给API的值，参数可以有多种类型。其中，使用oneof关键字可以定义一组可选的参数类型，只能选择其中的一个。

在Swagger中，使用oneof关键字可以定义一个参数为多个可能值的枚举类型。通过使用oneOf属性，可以指定一组可能的参数类型，然后在每个参数类型中使用$ref引用其他定义的参数模式。

下面是一个使用oneof关键字的示例：

## Parameters

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| type     | string | 参数类型，可选值为 `A`, `B` 或 `C` |
| value    | object | 取决于 `type` 的不同值，可能有不同的参数 |

### 参数模式 A

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| a1 | integer | 参数A1的值 |
| a2 | string | 参数A2的值 |

### 参数模式 B

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| b1 | boolean | 参数B1的值 |
| b2 | number | 参数B2的值 |

### 参数模式 C

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| c1 | array | 参数C1的值 |
| c2 | string | 参数C2的值 |

在上面的示例中，使用了oneof关键字来定义类型为string的参数type，它的可选值为 A, B 或 C。对应不同的参数类型，使用了A, B 和 C三个参数模式来描述不同类型的参数。

这样，程序员就可以根据具体需求选择合适的参数类型，并在相应的参数模式下查看每个参数的描述及其类型。

以上就是一个使用oneof关键字的Swagger参数示例，它可以帮助程序员更好地理解如何定义和使用oneof参数。