swagger 相关问题

当正文中的枚举值无效时，如何在 .NET API 中显示更有意义的错误

我有一个 API 端点，其中主体有一个枚举。如果枚举的值无效，用户将收到一个有点难以理解的错误（在我看来），例如： { &q...

无法使用 springdoc-openapi-starter-webmvc-ui 加载自定义 openapi.yaml 文件

我正在使用 Spring Boot 3 和库 springdoc-openapi-starter-webmvc-ui 来获取 swagger 文档。当从

Swagger XML 示例值不遵守类上的 XML 注释

鉴于这门课： [XmlRoot("MySample", 命名空间 = "http://mynamespace.org")] 公开课样本 { [XmlAttribute(“版本”)] 公共字符串

java 的 openApi 生成器错误

public CreateUserAccountRequest qradarAllowedDomainIds（列表qradarAllowedDomainIds）{ this.qradarAllowedDomainIds = qradarAllowedDomainIds; 返回这个=； } 公开

如何在docker中添加并启用swagger-ui配置？

我正在尝试使用配置选项配置 docker-compose 部署的 swagger-ui，以便启用 requestSnippets 选项。 我的 docker-compose 服务： --- 版本：'3.8' 服务： 霸气...

Swagger/OpenAPI 到人类可读文档（Excel、Word ...）的转换

是否有一些工具可以从 YAML 中的 Swagger/OpenAPI 规范生成 MS Excel/MS Word 格式的 REST API 规范或任何其他人类友好的表格文档。结果应该是可以访问的...

NodeJS 在 Swagger 文档中添加授权按钮

我需要能够将以下按钮添加到 Swagger 的 UI 界面，以便测试人员可以添加“Bearer token”标头并测试 api。 我的招摇的选项定义是： 模块。

如何在 OpenAPI (Swagger) 中将 $ref 属性声明为只读？

我试图在此示例中为“House”添加一个只读字段。房子是另一个我想要只读的模型。 在此示例中，可以将 Dogs 数组设置为只读而不会出现错误...

如何使用 Swagger 正确记录字符串化 JSON？

在与 ChatGPT 争论这个问题之后，我怀疑我想要实现的目标是不可能的，但希望还没有完全消失。 我有一个 API 端点，它返回一个 JSON 响应，其中包含...

ASP.NET Core Web API：在 Azure Devops 管道中提取 Swagger

我有一个 ASP.NET Core Web API，我在 Azure Devops Pipeline 中构建它。构建完成后，我想提取 swagger.json。 问题是有问题的命令尝试我想启动...

Swagger 无法使用 Yaml 文件找到用户架构

这里是使用 swagger 的初学者。我尝试创建一个简单的端点文档。但我无法弄清楚我的架构类型有什么问题。 我首先创建文件夹结构：在我的根 src 中，我...

Swagger 无法在 .Net core 项目的 Docker 中工作？

net core Web API 应用程序。我已经使用 Azure AD 身份验证创建了 swagger。当我使用 IIS 时，我的 swagger 可以正常工作。当我使用 docker 运行时，我得到此站点无法访问。下面是我的

如何在 OpenAPI 中定义 json-lines 响应？

有没有办法用 OpenAPI 描述 json-lines ？ 除了似乎还没有 MIME 类型这一事实之外，我想知道是否可以描述这样的响应。 理论上我的反应...

Swagger 对 Apache Camel 4 的支持

我正在从 Apache Camel 3.20.x 升级到 4.x.x，发现 Camel 3 支持的camel-swagger-java（版本 3.20.x）不受 Camel 4 支持。图书馆还没有

向 OpenAPI 3.0.x 中的现有响应架构添加新属性

我有四个路径a、b、c、d。所有路径以前都具有相同的属性和模式。现在有一个新的要求，路径c和d将在名为rex的属性中发生变化。定位很重要...

在 swagger 中启用身份验证

我创建了一个在.net6上运行的asp.net core空项目。当我尝试在 swagger 中启用身份验证时遇到一个问题。 Swagger UI 按预期运行，唯一的问题是每当我...

如何在Springdoc-openapi中的模式示例中设置值null而不是“null”？

我正在使用 Springdoc-openapi 并有一个像这样的 dto： @Schema(标题 = "财务状况") @JsonIgnoreProperties（ignoreUnknown = true） 公共类当前财务条件{ @

规范中没有定义任何操作！在 swagger ui 和 springfox 中指定多个路径时

我想在 Swagger ui 中显示两个 REST API 端点：/cart 和 /post。 当我指定 /cart 或 /post 工作正常但两者都显示错误为 规范中没有定义任何操作！ 在SW...

如何使用 io.swagger.core.v3:swagger-jaxrs2 始终生成具有相同元素顺序的 yaml？

我需要为我的应用程序生成 yaml 文件，但我需要每次生成它时都相同，以便将当前生成的 yaml 与 API 的当前状态进行比较。 但我是

Nest.js swagger 模块 - dto 中的对象在 swagger 中不可见

我正在使用 swagger 在 Nest js 中实现小型应用程序，我有一列（postgresql）作为 json 对象（typeorm 中的简单 json 类型），并且嵌套对象在 swagger 中不可见。我的代码： @