在OpenAPI 2中等效使用其中一个（来自OpenAPI 3）

Question

如何使用oneOf将此代码段调整为等效的OpenAPI 2.0版本？

  formats:
    type: array
    description: Possible parameter format.
    items:
      oneOf:
      - type: string
      - type: object
        description: Matched alias formats
        properties:
          representation:
            type: array
            description: Alias format representations
            items:
              type: string
          match_multiple:
            type: boolean
            optional: true
          display:
            type: string
            description: Display string of alias format

Answer 1

在OpenAPI 2.0中，您最多可以为项目使用无类型模式{}，这意味着项目可以是除null之外的任何内容-数字、对象、字符串等。您无法指定项目的确切类型，但您可以添加具有不同项目类型的数组的示例。

formats:
  type: array
  items: {}  # <--- means "any type" (except null)

  example:
    # example of a string item
    - test

    # example of an object item
    - representation: [one, two]
      match_multiple: false
      display: something

注意：无类型模式{}只能在OAS2主体参数和响应模式中使用。Path、header和form参数要求数组项使用原语类型。