Swagger是一个框架实现,用于基于Open API规范描述,生成,使用和可视化RESTful Web服务
FastAPI - 成功登录后,没有收到授权标头,也来自 Swagger,并且仅在部署在服务器上时
我的 FastAPI 在我的本地主机中工作,但是当部署在服务器上时,会发生以下情况: 登录成功并从响应中检索令牌。 成功登录后,任何需要
如何创建对其他子文件具有 $ref 的 OpenAPI 规范文件?这可能吗?
我无法让 OpenAPI 规范 Swagger“外部引用”工作,因为 Swagger 渲染给了我一个例外。 我必须拥有这个才能使编辑巨型大张旗鼓的文档更易于管理...
为什么找不到方法app.UseSwaggerUI(...)?
我想在使用 .NET Core 3.1 创建的新 Web 应用程序上添加 swagger。我在以下行收到错误: 应用程序.UseSwaggerUI(c => { c.SwaggerEndpoint("/swagger/v1/swagger.json&...
在 docker-compose 中更改 Swagger 端口
我无法更改 Swagger 在 docker compose 中使用的端口。它与常规 docker 一起工作得很好,我只需在运行命令上设置 -p 参数即可。看来我只需要设置 p...
springfox 与 springboot 3.0.2 兼容哪个版本 我试图将 springfox 3 合并到 springboot 3 中。虽然我的控制台没有显示错误,但 swagger ui 没有出现。但是一个...
使用 NSwag 生成 C# 客户端会在同一个文件中错误地创建 2x 个同名的部分类
我正在尝试从 OpenAPI json 文件生成 NSwag C# 客户端。 当我这样做时,我确实生成了一个客户端文件,但它无法编译。它在同一个 .cs 文件中创建了 2x 部分类...
Swagger 的操作过滤器无法正常工作 - 它在每个 api 端点上显示授权选项
我正在使用.net6.0创建一个api。我想为 api 文档添加 Swagger UI,我添加了它,并且它在大部分情况下都有效。我面临的唯一问题是 swagger UI 在电子设备上显示挂锁...
使用 swagger 2.0(甚至 3.0),是否可以将枚举值标记为已弃用?
我们使用 Java 类型生成器将枚举类型从 Swagger 2.0 修改为 Java 枚举,并且在某些情况下我们需要反序列化已从代码库中删除的枚举值,因此...
我正在使用 Swagger 2.0 来定义我们的 API 契约模式,我们计划在其中使用带有判别器的多态性。我有一个父类(名为 Animal)和两个扩展 Animal 的子类......
部署在 Vercel 上时,我的 swagger ui 显示空白页面(NodeJs NestJS Swagger)
我遇到以下问题,在 localhost 上它工作正常,在 AWS EC2 服务器上也工作正常,但是当我在 Vercel 上部署应用程序时,应该显示我的 Swagger UI 的路径(例如:localhost:8080/swagger.. .
@ControllerAdvice 将所有可用的异常推送到响应描述,即使它无法抛出
我有一个简单的 Spring Boot 应用程序,其中包含多个 @RestController 和一个全局异常处理程序作为 @ControllerAdvice,它使用自定义代码和错误 dto 处理一些自定义异常。阿尔...
我有一个全新的 .NET-Core Web API 项目,我想使用 API 版本控制和 swagger。 当我尝试查看 swagger 页面时,我收到 404。但是,
我看到OpenAPI中有一个字符串的日期格式,并且通过使用dateLibrary=java8,我们可以使用openapi-generator生成LocalDate字段。 但是有没有办法产生 LocalTime
zircote/swagger-php - 跳过未知的 La\Product
问题 我正在尝试使用 zircote/swagger-php 从 PHP 代码生成 OpenApi 文件。由于某种原因,我不断收到以下错误: 警告:跳过未知的 La\Product 警告:必填@OA\
FastAPI - @Schema(hidden=True) 在尝试隐藏 swagger 文档上的架构部分时不起作用
我试图隐藏 FastAPI 生成的 swagger 文档的整个模式部分。我已经检查了文档并尝试了此操作,但架构部分仍然显示。 @Schema(隐藏=真) 类...
我正在使用 swagger 编辑器,并已将 openapi 规范作为 yaml 导入,但由于所有外部引用而显示错误 - $ref: '#/components/parameters/orgIdPathParam' 这指向
我正在设置一个新的.NET 8 API,使用 Identity 来处理身份验证过程。 我在大肆设置不记名令牌身份验证时遇到问题。 所以环顾四周后我想到了......
如何在开放 API 规范中为字符串类型的属性指定空字符串值作为默认值
我有一个打开的 api yaml 文件,如下所示。我想将空字符串值指定为字符串类型属性的默认值。有什么方法可以做到这一点 测试: 类型:对象 必需的: ['', ''] 特性: 测试...
如何将 Springdoc Swagger UI 指向我自己的 YAML 文件而不是自动生成的文件?
我创建了一个 Spring Boot RESTFul 微服务,对于文档,我创建了一个 swagger.yaml 文件,但我不知道如何运行该文件。为了创建 swagger.yaml 文件,我使用了 O...
当 API 中未发送必填字段值时,如何在 swagger 中自定义错误消息?
下面是我的api.yml: 开放API:3.0.0 信息: 标题:“自动送货 API” 描述:“自动投递 API 文档” 服务条款:'https://www.yopmail.com' 接触: 名称: