Fail reference resolving with array type without items property

[MugeSo]

swagger-ui version: 2.1.4

{
  "swagger": "2.0",

  "basePath": "/api",

  "info": {
    "title": "sample",
    "version": "1.0.0"
  },

  "paths": {
    "/foo": {
      "get": {
        "description": "Foo",
        "produces": [
          "application/json"
        ],
        "responses": {
          "200": {
            "description": "A list of pets.",
            "schema": {
              "type": "array"
            }
          }
        }
      }
    }
  }
}

For example, schema definition for json-schema its self has this.

[fehguy]

It's not supported. Per the specification, items is required under an array, see the docs.

[MugeSo]

@fehguy How about this:

{
  "swagger": "2.0",

  "basePath": "/api",

  "info": {
    "title": "sample",
    "version": "1.0.0"
  },

  "paths": {
    "/foo": {
      "get": {
        "description": "Foo",
        "produces": [
          "application/json"
        ],
        "responses": {
          "200": {
            "description": "A list of pets.",
            "schema": { "$ref": "http://json-schema.org/schema#"  }
          }
        }
      }
    }
  }
}

[fehguy]

I don't know what you mean--I do suggest reading the specification so you can understand what is possible.

[MugeSo]

I got it.

[MugeSo]

@fehguy Please teach me where is the description that items is required in Schema Object.
I can find description about items required in Header Object and Parameter Object but I can't for Schema Object

[ponelat]

@MugeSo the swagger spec, is based on JSON-Schema, in the Schema Object you'll note a reference to items which is gets from JSON-Schema.

However, that said. Its a simple property, and you use this description as a reference... https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#itemsObject

[MugeSo]

@ponelat Thanks, I understand items in Items Object is required when type is array.
There is still no description items property of Schema Object.
However I found it is just a omission in spec.

I disappointed found that we can not reference many of existing json schema...

Thanks a lot.

[MugeSo]

OAI/OpenAPI-Specification#413
OAI/OpenAPI-Specification#404

[MugeSo]

@fehguy @ponelat
I read spec carefully.
And I feel sure items of Schema Object is optional for now.

@ponelat refers Item Object but it is not for schema in body and response.

A limited subset of JSON-Schema's items object. It is used by parameter definitions that are not located in "body".

[webron]

@MugeSo - as someone who was involved in writing the spec, I can tell you the intent - items is mandatory no matter where you declare the type to be an array. We can go back and forth on this, but it won't change.