OpenAPI 3.0 ref for array

Question

I have recently delved into the OpenAPI specifications and have been making use of redoc-cli, however, I have come across a small problem.

I have the following:

      "OrderResponse": {
        "allOf": [
          "$ref": "#/components/schemas/QuoteOrderResponse",
          {
            "type": "object",
            "properties": {
              "trips": {
                "type": "array",
                "$ref": "#/components/schemas/QuoteOrderResponse"
              }
            }
          }
        ]
      },

However, the resulting output is in the form of an object.

Hope there are some gurus here that are able to help me to see what is wrong with this. Cheers.

This doesn't look like a valid JSON - it' needs `{ }` around the `"$ref": "..."` key/value. — Helen, Jan 12 '21 at 17:20

score 2 · Answer 1 · answered Jan 13 '21 at 07:16

update on this issue, I have found the error, it was a simple mistake which I overlooked.

Basically had to do:

        "allOf": [
          "$ref": "#/components/schemas/QuoteOrderResponse",
          {
            "type": "object",
            "properties": {
              "trips": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/QuoteOrderResponse"
                }
              }
            }
          }
        ]
      }

OpenAPI 3.0 ref for array

1 Answers1