在OpenAPI中重用枚举的子集（Swagger）

Question

paths:
  /products:
    get:
      parameters:
      - in: query
        name: color
        required: true
        schema:
          $ref: '#/components/schemas/Color'
      responses:
        '200':
          description: OK
components:
  schemas:
    Color:
      type: string
      enum:
        - black
        - white
        - red
        - green
        - blue

Answer 1

没有很好的方法重用枚举的一部分。最好的方法是定义单独的枚举。

一个可能的解决办法是使用中的一个将部分枚举“组合”到完整枚举中。但是，枚举模式之一可能不能在Swagger UI和代码生成器中用作枚举。

components:
  schemas:
    BlackOrWhite:
      type: string
      enum:
        - black
        - white
    Color:
      oneOf:
        - $ref: '#/components/schemas/BlackOrWhite'
        - type: string
          enum:
            - red
            - green
            - blue

YAML&锚和合并键<<的技巧将不起作用，因为YAML只支持映射（对象）中的合并键，而不支持序列（数组）中的合并键。

# This will NOT work in YAML

components:
  schemas:
    BlackOrWhite:
      type: string
      enum: &BLACK_WHITE
        - black
        - white
    Color:
      type: string
      enum:
        << : *BLACK_WHITE
        - red
        - green
        - blue