swagger-ui 相关问题

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

OpenAPI Yaml 如何定义 Enum 继承

我正在开发一个在 yaml 文件中设计的 Springboot REST API,如下所示。 /控制器/myApi: 邮政: 标签: - ... 操作 ID:postNewStudent 请求正文: 内容:

回答 1 投票 0

使用包 Swashbuckle.AspNetCodre.Annoatations 后,Swagger UI 的响应正文显示字符串而不是 json 对象

响应正文变为字符串: "{"id":"96dad743-138e-4b70-8316-5ced38ba56fe","name":"测试","hexColor":"121213","isActive&

回答 1 投票 0

带有 OpenAPI/Swagger-UI 的 Spring 资源服务器 (OAuth2.1)

背景:我有2个应用程序: Spring授权服务器通过authorization_code流程对用户进行身份验证。另一种情况也与 PKCE 相关。 http://192.168.0.4:8001 春季资源

回答 1 投票 0

NetCore6:SwaggerUI:输出为 JSON 而不是字符串

我尝试按照此处所述启用响应压缩,并且成功了,每个 Chrome 的输出从 4.9 MiB 减少到 700 KiB SwaggerUI 输出看起来像 JSON(JSON/颜色格式...

回答 1 投票 0

锁定失败:类型错误:在intrinsics.Object.groupBy预期的布尔值不是函数

lockdown-run.js:17 锁定失败: 类型错误:在intrinsics.Object.groupBy预期的布尔值不是函数 lockdown-more.js:99 保护内在函数失败: 参考错误:强化未定义 (

回答 1 投票 0

更改 Spring Boot 中的 swagger ui 基本路径

在我的 Spring Boot 应用程序中,我使用 swagger 来记录文档。我需要将默认的 http://localhost:8080/swagger-ui.html 路径更改为 http://localhost:8080/docs/swagger-ui.html 因为我...

回答 1 投票 0

Dotnet Core 和 Swagger:防止 Swagger UI 未经身份验证

各位开发者大家好, 我实现了一个具有多个端点的服务器,并集成了 Swashbuckle Swagger UI 中间件。 每个人都可以访问这个中间件,无需登录...

回答 1 投票 0

如何在Swagger-ui中的服务器列表中预先选择服务器?

访问swagger-ui页面时如何在服务器列表中预先选择选定的服务器? 我使用 Spring boot 和 Springdoc 生成 swagger-ui。我有以下 bean 将服务器列表添加到

回答 1 投票 0

由于内容安全策略,Swagger UI 是空白的

我正在尝试修复 swagger UI 的内容安全策略问题。我正在寻找一种添加标头或 Springfox 配置选项来解决问题的方法。 它无法加载 UI 和 v2/api-doc...

回答 3 投票 0

开放 API v3 - 从架构中删除类型

我们正在将一个项目从 swagger v2 迁移到 OpenAPI v3 版本,我们面临着标头没有类型的情况。即,手动更新生成的标题的 swagger 文件...

回答 1 投票 0

Spring boot 3 和 Swagger ui java.lang.NoSuchMethodError: 'io.swagger.v3.oas.annotations.media.Schema$AdditionalPropertiesValue otherProperties()

嗨,升级到 Spring Boot 3 后,我遇到了 swagger ui 的问题。swagger-ui 不再工作,我得到了 404 和“白标签”页面作为响应。 近距离观察后...

回答 3 投票 0

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

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