驗證錯誤：數據不匹配任何模式「oneOf」

Question

，我發現了錯誤Data does not match any schemas from 'oneOf'與以下規範：

{ 
    "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": "" 
     } 
     } 
    } 
    } 
} 

這充分errorfrom招搖工具驗證：

#/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 

我不明白錯誤或如何解決。

Answer 1

您不能在body參數中包含type。這就是爲什麼有schema。試試這個：

{ 
    "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": "" 
     } 
     } 
    } 
    } 
}