Swagger 尝试使用时出现招摇过市架构错误
我有一个与类似的错误,但在我的例子中,我引用了#/定义,因此我希望得到一些帮助 我尝试创建一个显式对象: responses: '200': content: application/json schema: type: object properties: id: integer 响应: '200': 内容:application/json 模式: 类型:对象 特性: id:整数 这给了我:Swagger 尝试使用时出现招摇过市架构错误,swagger,swagger-2.0,swagger-editor,Swagger,Swagger 2.0,Swagger Editor,我有一个与类似的错误,但在我的例子中,我引用了#/定义,因此我希望得到一些帮助 我尝试创建一个显式对象: responses: '200': content: application/json schema: type: object properties: id: integer 响应: '200': 内容:application/json
路径['/user']处出现架构错误。post.responses['200'] 不应具有其他属性 additionalProperty:内容、架构 跳到119线 我还尝试: responses: '200': $ref: '#/definitions/UserCreateResponse' 响应: '200': $ref:“#/definitions/UserCreateResponse” 这让我明白:
路径处的语义错误。/user.post.responses.200.$ref 200$ref不能与以下任何一项匹配:“#/definitions”、“#/parameters” 跳到120线
如果我使用$ref,对象将按需要显示,但错误仍然存在于编辑器中。@Stijn向我指出了一个解决方案:编写代码,然后根据该代码生成招摇过市代码
另外,使用在线编辑器(此处链接:)而不是我的本地Docked版本也解决了这个问题。您的第一个示例无效。改为:
产生:
-application/json#您试图手工构建模式而不是使用众多生成器(由swagger自身和第三方实现提供)中的一个生成器的原因是什么?经验不足。我使用的是Swagger编辑器(),这就是我看到错误的地方:有更好的方法吗?取决于您使用的语言和框架。例如,ASP.NET Web API有NSwag和Swashback,它们都根据您编写的API为您生成规范。手工编写是可行的,但很容易出错,而且在维护方面对开发人员不友好。