Errore di convalida: dati non corrisponde ad alcun schemi da 'oneOf'

Question

sto ottenendo l'errore Data does not match any schemas from 'oneOf' con la seguente specifica:

{ 
    "info": { 
    "version": "1.0.0", 
    "title": "REST API" 
    }, 
    "paths": { 
    "/doit": { 
     "post": { 
     "responses": { 
      "200": { 
      "description": "Successful response" 
      } 
     }, 
     "parameters": [ 
      { 
      "type": "object", 
      "schema": { 
       "$ref": "#/definitions/ResponseDefinition" 
      }, 
      "required": "true", 
      "name": "docs", 
      "in": "body" 
      } 
     ] 
     } 
    } 
    }, 
    "swagger": "2.0", 
    "definitions": { 
    "ResponseDefinition": { 
     "type": "object", 
     "properties": { 
     "text": { 
      "type": "string", 
      "description": "" 
     } 
     } 
    } 
    } 
} 

Questa full errorfrom la spavalderia-tools validatore:

#/paths/~1doit/post/parameters/0: Data does not match any schemas from 'oneOf' 
#/paths/~1doit/post/parameters/0: Data does not match any schemas from 'oneOf' 
    #/required: Expected type boolean but found type string 
    #/: Missing required property: type 
#/paths/~1doit/post/parameters/0: Additional properties not allowed: in,name,required,schema 

Non capisco l'errore o come risolverlo.

Answer 1

Non è possibile includere type in un parametro body. Ecco perché c'è lo schema. Prova questo:

{ 
    "info": { 
    "version": "1.0.0", 
    "title": "REST API" 
    }, 
    "paths": { 
    "/doit": { 
     "post": { 
     "responses": { 
      "200": { 
      "description": "Successful response" 
      } 
     }, 
     "parameters": [ 
      { 
      "schema": { 
       "$ref": "#/definitions/ResponseDefinition" 
      }, 
      "required": "true", 
      "name": "docs", 
      "in": "body" 
      } 
     ] 
     } 
    } 
    }, 
    "swagger": "2.0", 
    "definitions": { 
    "ResponseDefinition": { 
     "type": "object", 
     "properties": { 
     "text": { 
      "type": "string", 
      "description": "" 
     } 
     } 
    } 
    } 
}