Forum Discussion

lnash94's avatar
lnash94
Occasional Contributor
4 years ago

How to document multiple data types array in OpenAPI Definition

Hi all, I'm looking for an OpenAPI representation for an array type when the array has one specific data type item at one time, the array data type can be multiple types. That means as an example:  ...
Swagger Core
  • HKosova's avatar
    HKosova
    3 years ago

    You are almost there. Here's how to define a non-mixed array:

     

    arry:
  oneOf:
    - type: array
      items:
        type: integer
    - type: array
      items:
        type: string

     

     

    Depending on how well your tooling handles "oneOf", this can be simplified into:

     

    arry:
  type: array
  oneOf:
    - items:
        type: integer
    - items:
        type: string

     

HKosova's avatar
HKosova
SmartBear Alumni (Retired)

You are almost there. Here's how to define a non-mixed array:

 

arry:
  oneOf:
    - type: array
      items:
        type: integer
    - type: array
      items:
        type: string

 

 

Depending on how well your tooling handles "oneOf", this can be simplified into:

 

arry:
  type: array
  oneOf:
    - items:
        type: integer
    - items:
        type: string

 

lnash94's avatar
lnash94
Occasional Contributor
3 years ago

Thank you HKosova , This solution fits to my requirement of tool ðŸ™‚