How to define a nested array in OpenAPI?

Question

I want to define this

     "locationPoly": [
          [-87.63466, 24.50182],
          [-80.03074, 24.50182],
          [-80.03074, 31.00107],
          [-87.63466, 31.00107],
          [-87.63466, 24.50182]
        ],

In my OpenAPI YAML schema, I defined it like this:

                  locationPoly:
                    type: array
                    properties:
                      type: array
                      properties:
                        type: number

But I am getting the "schema is invalid" error. Is there another way to define this?

Software2 · Accepted Answer · 2022-01-26 12:08:30Z

4

Arrays must use the items keyword.

locationPoly:
  type: array
  items:
    type: array
    items:
      type: number

edited Jan 26, 2022 at 12:08

answered Jan 26, 2022 at 6:35

Software2

2,7981 gold badge24 silver badges30 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Software2 Over a year ago

Per @Helen 's idea, If the inner arrays always contain 2 elements, you can add minItems: 2 and maxItems: 2 for documentation purposes. Though IMO, if you're going to begin to define criteria like that, it's better to explicitly define an object schema that can be reusable. (Either way, it's an optimization outside of the question asked.)

Helen · Accepted Answer · 2022-01-27 09:15:56Z

In your example, the locationPoly array appears to contain coordinates. A pair of coordinates can be considered a tuple (ordered list). If you're using OpenAPI 3.1 (or will be using it in the future), it has the prefixItems keyword to define tuples. This way you can provide separate descriptions for individual elements of the tuple (i.e., for the 1st and 2nd items of the inner arrays in your example).

# openapi: 3.1.0

  locationPoly:
    type: array
    items:
      $ref: '#/components/schemas/Coordinates'
...

Coordinates:
  type: array
  prefixItems:
    # The 1st item
    - type: number
      description: Latitude
      minimum: -90
      maximum: 90
    # The 2nd item
    - type: number
      description: Longitude
      minimum: -180
      maximum: 180
  minItems: 2
  maxItems: 2
  additionalItems: false # Can be omitted if maxItems is specified

Collectives™ on Stack Overflow

How to define a nested array in OpenAPI?

2 Answers 2

1 Comment

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

2 Answers 2

1 Comment

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related