support for schema types

[ericgazoni]

In swagger we can define "models" or "schemas" for complex JSON structures.

This is not properly handled at the moment.

basic type definition

{
    "default": "",
    "type": "string",
    "name": "filter",
    "in": "query",
    "format": "string",
    "required": false,
    "description": "Custom filter"
},

with schema

{
    "name": "POST body",
    "in": "body",
    "description": "Book attributes",
    "schema": {
        "$ref": "#/definitions/Book_post"
    },
    "required": true
}

corresponding schema

"Book_post": {
    "properties": {
        "data": {
            "example": {
                "attributes": {
                    "title": "",
                    "reader_id": "",
                    "author_id": "",
                    "publisher_id": ""
                },
                "type": "Books"
            },
            "type": "string"
        }
    }
},