Swagger 错误 : additionalProperty: 3XX, 4XX、5XX

标签 swagger openapi swagger-2.0 swagger-editor

我在 swagger 响应部分添加了一些错误代码: 201、3XX、400、401、4XX、5XX。

此外,根据 swagger2.0 文档,您可以拥有: “允许以下范围定义:1XX、2XX、3XX、4XX 和 5XX。如果使用显式代码定义响应范围,则显式代码定义优先于该代码的范围定义。”

但我仍然收到错误: “不应该有额外的属性。additionalProperty:3XX,4XX,5XX”

有什么线索吗?

最佳答案

该引用来自 OpenAPI 3.0 规范,而不是 2.0。

2.0 spec不支持通配符响应代码。您需要使用特定的代码,例如200400404等,可以使用默认 code> 响应以匹配您的规范未单独涵盖的所有 HTTP 代码。

关于 Swagger 错误 : additionalProperty: 3XX, 4XX、5XX,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/45745710/

相关文章:

json - 如何使用 swagger-node 生成/使用 XML

Swagger 继承和组合

Swagger 3.0.0 代码生成失败 java.lang.RuntimeException : missing swagger input or config

asp.net-core - 如何从 OpenAPI 3.0 架构生成 ASP.NET Core 2 Controller ?

Azure API 管理 - 使用 Swagger 2.0 规范导入 API - 不考虑响应的架构属性

java - 如何在 swagger-ui 中获取 POST 数据?

spring-mvc - Spring Swagger UI : what is difference between io. swagger、io.springfox 和 com.mangofactory

java - REST API 的 JSON 响应

rest - 如何将 Swagger OpenAPI 规范添加到 Spring Boot 项目中?

rest - OpenAPI 3 -- 属性在写入时是可选的,但在读取时是必需的