如何在Open API 3.0中根据枚举选择动态展示不同字段

完全可以实现这个功能，OpenAPI 3.0及以上版本提供了if/then/else关键字，结合枚举字段就能实现这种"根据选择控制必填字段"的逻辑。

具体实现思路如下：

• 先定义包含strategy枚举字段的基础对象Schema
• 通过if判断strategy的取值，用then指定对应情况的必填字段和字段定义，else处理另一种情况
• 也可以用oneOf来确保仅满足其中一种条件约束，避免出现冲突的字段组合

下面是完整的YAML示例：

openapi: 3.0.3
info:
  title: 策略配置API
  version: 1.0.0
components:
  schemas:
    StrategyConfig:
      type: object
      required: [strategy]
      properties:
        strategy:
          type: string
          enum: [USE_FORMULA, DEFINE_VALUES]
          description: 策略类型选择
      # 条件约束逻辑
      if:
        properties:
          strategy:
            const: USE_FORMULA
      then:
        required: [formula]
        properties:
          formula:
            type: string
            description: 计算用的公式表达式
      else:
        required: [field1, field2]
        properties:
          field1:
            type: number
            description: 自定义数值字段1
          field2:
            type: number
            description: 自定义数值字段2

这个配置的效果是：

• 当strategy选USE_FORMULA时，API会要求必须提供formula字段，其他字段（field1/field2）非必填
• 当strategy选DEFINE_VALUES时，必须提供field1和field2，formula字段非必填

如果需要更严格的约束（比如不允许同时出现formula和field1/field2），可以加上oneOf关键字来限定仅能满足一种条件：

oneOf:
        - properties:
            strategy:
              const: USE_FORMULA
          required: [formula]
        - properties:
            strategy:
              const: DEFINE_VALUES
          required: [field1, field2]

大多数主流的API文档工具（比如Swagger UI、Redoc）都能识别这种条件配置，会根据用户选择的strategy值动态显示/隐藏对应的字段，提升交互体验。

内容的提问来源于stack exchange，提问作者Timothy Robinson