swagger-ui 相关问题

Swagger UI是HTML,CSS和JavaScript对象的集合,可以从符合Swagger的API动态生成文档

Multer 上传不是 swagger UI / Nodejs 中的功能

我正在使用 Multer 在 swagger UI 中制作上传文件系统。 我发现这个 screenShot 问题 - 上传不是一个功能 这是类别。上传.js const multer = require("multer"); 缺点...

回答 1 投票 0

突然 Springfox Swagger 3.0 无法与 spring webflux 一起使用

几天前,应用程序正在与 Springfox Swagger 3.0 配合使用。突然它停止工作了。一周前创建的 Jar 文件仍然有效,但现在当我们尝试构建新的 Ja...

回答 8 投票 0

springboot swagger3“加载远程配置失败。”

Spring Boot 2.6.3 与 Springdoc。 org.springdoc springdoc-openapi-ui ...

回答 8 投票 0

如何在 ASP.NET Core 中的 Swagger 中包含 XML 注释文件

我需要 Swagger 生成 API 文档,包括 UI 来测试操作。 当我的项目中使用ASP.NET时,生成了deps XML文件,一切正常,如下所示: 但是当我使用 ASP.NET Cor...

回答 7 投票 0

从模式生成静态API文档?

我有 Koa/Express 应用程序,希望根据不同 API 路由的注释生成静态文档。 Swagger 似乎不错,但我发现的所有包都没有生成

回答 2 投票 0

Spring boot Swagger UI启动时出现异常

我正在尝试让 Swagger UI 在我的项目中工作,并且我正在遵循这些文档,但是无论我尝试什么,我的应用程序都会立即崩溃,并出现以下异常: 继续时遇到异常...

回答 2 投票 0

检测到无效的映射模式:/**/swagger-ui/**

我正在使用 springdoc-openapi-ui 作为 Spring Boot API 文档并面临以下问题 - 我已添加所有必要的配置,如下 - Maven 依赖 - 我正在使用 springdoc-openapi-ui 作为 Spring Boot API 文档并面临以下问题 - 我已添加所有必要的配置,如下 - maven 依赖 - <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> <version>1.5.2</version> </dependency> 这是主文件 - package com.abc.tl; import io.swagger.v3.oas.annotations.OpenAPIDefinition; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication @OpenAPIDefinition public class TLApplication { public static void main(String[] args) { SpringApplication.run(TLApplication.class, args); } } 使用java版本 - 11,不知道问题出在哪里,项目无法运行。 通过以下依赖项,解决了这个问题。 <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.6.0</version> <relativePath /> <!-- lookup parent from repository --> </parent> <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> <version>1.5.12</version> </dependency> 我在我的应用程序 application.properties 中添加了对我有用的以下行。 spring.mvc.pathmatch.matching-strategy = ANT_PATH_MATCHER 以上项目有效 spring.mvc.pathpattern.matching-strategy=ant_path_matcher 但是,它应该是ant-path-matcher - 破折号而不是下划线 似乎PathPatternParser不允许**出现在中间,并且会拒绝这样的模式(查看更多详细信息:https://github.com/spring-projects/spring-boot/issues/21694 )。 看起来这里的代码在路径模式的中间插入了一个**。 uiRootPath.append(ALL_PATTERN); registry.addResourceHandler(uiRootPath + SWAGGER_UI_PATTERN) 完整代码 @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { StringBuilder uiRootPath = new StringBuilder(); if (swaggerPath.contains(DEFAULT_PATH_SEPARATOR)) uiRootPath.append(swaggerPath, 0, swaggerPath.lastIndexOf(DEFAULT_PATH_SEPARATOR)); if (actuatorProvider.isPresent() && actuatorProvider.get().isUseManagementPort()) uiRootPath.append(actuatorProvider.get().getBasePath()); uiRootPath.append(ALL_PATTERN); registry.addResourceHandler(uiRootPath + SWAGGER_UI_PATTERN) .addResourceLocations(CLASSPATH_RESOURCE_LOCATION + DEFAULT_WEB_JARS_PREFIX_URL + DEFAULT_PATH_SEPARATOR) .resourceChain(false) .addTransformer(swaggerIndexTransformer); } 在你的代码中的某个地方(我猜是在安全配置中)你已经配置了/**/swagger-ui/**。最近(Spring 5.3)这些路径配置现在由 PathPatternParser 进行分析(取代了旧的 AntPathMatcher,允许像这样的路径)。 按照建议将 spring.mvc.pathpattern.matching-strategy=ant_path_matcher 添加到您的 application.properties 或将路径配置更改为 "/webjars/swagger-ui/**" 之类的内容。 就我而言,我使用的是旧版本的springdoc-openapi-uispringdoc-openapi-data-rest,它恰好与最新版本的Spring Boot不兼容。在 https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-ui 上查找最新的 maven 包并使用该版本,解决了问题。 我添加了这一行,我这边正在工作 application.properties spring.mvc.pathmatch.matching-strategy = ANT_PATH_MATCHER 就我而言, springdoc-openapi-ui 处于出色的模块中。我只是排除 springdoc-openapi-ui。 <dependency> <groupId>some.group</groupId> <artifactId>some.artifact</artifactId> <version>LATEST</version> <exclusions> <exclusion> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> </exclusion> </exclusions> </dependency>

回答 8 投票 0

相同状态代码200OK的多个ProducesResponseType

我正在使用 swagger ui,我的控制器中有这样的操作: [HttpGet("{id}")] [允许匿名] [ProducesResponseType(typeof(PublicDto), StatusCodes.Status200OK)] [产生回应...

回答 2 投票 0

Spring boot 3.1.3 和 OpenAPI v2.2.0:@OpenAPIDefinition 和 @SecurityScheme 不起作用

我已经开始了新的Spring Boot 3.1.3。对于API文档,我遵循官方Springdoc springdoc-openapi v2.2.0文档,一切正常。然后我添加了一个新的空类到

回答 1 投票 0

Swagger 请求返回 404 Not Found

这是 .NET Core 3.1 上的 ASP.NET MVC 应用程序,带有 Swashbuckle.AspNetCore 6.1.4(最新)。当我尝试在 /swagger/index.html 加载 Swagger UI 时,收到 404。看起来 Swa...

回答 4 投票 0

Quarkus Swagger MongoDB ObjectId 格式

我正在用 quarkus-resteasy 和 mongodb 编写应用程序。安装 quarkus OpenAPI 后,我发现 swagger UI 无法正确显示 ObjectID 格式。 我想看一些东西...

回答 2 投票 0

Spring springdoc-openapi:找不到 swagger-ui/index.html status=404

我有一个依赖于 springdoc-openapi 的 spring boot 应用程序(2.5.6)。 但是,启动 swagger-ui (http://localhost:8080/v1/swagger-ui/index.html) 不起作用。 调试日志表明...

回答 4 投票 0

使用 swagger-client 将承载令牌添加到 swagger 请求

我正在尝试在登录帐户时将不记名 JWT 令牌添加到 swagger 请求中,但我似乎无法让它工作。该文档还有很多不足之处。 const SWAGGER_CLIENT = SwaggerCl...

回答 1 投票 0

创建名称为“swagger2Controller”的bean时出错:查找方法解析失败

在我的项目中实施 swagger 时,我面临这个问题。 这是我的 build.gradle 文件和我的 swagger 配置文件。 @配置 @EnableSwagger2 @EnableWebMvc 公共类 MisToolSwaggerCon...

回答 2 投票 0

Swagger UI 授权不发送令牌

我是 Swagger 新手。我正在使用 OpenAPI 3.0.2。 当我运行 Swagger UI 时,顶部和每个 API 都会出现授权按钮,但它们不起作用。当我点击它们时,我可以在应用程序中输入任何文本...

回答 2 投票 0

规范中没有定义任何操作! - 即使设置了招摇并且定义了端点,我也会收到此错误

我正在尝试使用 swagger npm 包在我的节点应用程序之上设置 swagger。我的终点和招摇设置很完美(至少几乎完美),我确实做了很多研究......

回答 12 投票 0

如何在我的 Swagger UI 中覆盖/自定义 OpenAPI 规范版本?

我不知道为什么这对我来说这么难,但我已经坚持了几个小时了。 我已经使用 yaml 文件和 openapi 3.0.0 规范为我的 API 定义了 Swagger UI。那个规格

回答 1 投票 0

使用 openAPI 文档中的鉴别器根据属性匹配正确的响应模式(在 swagger 等文档构建器中失败)

我正在尝试在 OpenAPI (v3) 中定义有效负载架构。有效负载有两个属性:ruleType 和pairs。该对的模式是一个对象数组。以及这些配对对象的模式

回答 1 投票 0

使用 .NET 从 swagger UI 中删除默认的“字符串”

我在 .NET 5 中使用 Swagger 单击“尝试一下”后,Swagger 将在正文中显示一个“字符串”。 (请看下面的截图) 我希望它显示“{}”。 这就是我...

回答 1 投票 0

Swagger UI:无法推断基本网址

我正在使用 Spring Boot 2.1.4.RELEASE 和 springfox-swagger2 2.9.2,并且能够从微服务获取数据(如果直接从浏览器使用 GET 操作访问) 问题:当我点击 Swaager UI 时...

回答 3 投票 0

© www.soinside.com 2019 - 2024. All rights reserved.