Swagger UI是HTML,CSS和JavaScript对象的集合,可以从符合Swagger的API动态生成文档
我正在使用Swagger 3.0。我无法在 swagger-ui 中映射示例请求中的对象列表。附上屏幕截图以供参考。其他数据类型也发生同样的情况,例如字符串...
我有一个 API 端点,它使用以下形式的查询参数响应 POST 请求: json_string = '{"物品":%20[{"名称":%20"鸡",%20"数量":%201...
FastAPI 生成的 API 文档下拉列表用于显示请求正文的多个示例,但仅显示 1 个示例
我正在关注FastAPI教程,特别是有关显示多个示例的部分:https://fastapi.tiangolo.com/tutorial/schema-extra-example/。 我复制了代码: 输入 import Opt...
在Springfox中自定义Swagger UI的标题和描述
我打算修改标题和描述。 我通过网上搜索发现的方法是使用 ApiInfoBuilder() 构造一个 ApiInfo,然后将其传递给 Docket 对象。 德斯皮...
我试图在 swagger 响应示例架构中将一些属性设置为非空,但我只需在视图模型示例上将属性设置为 [Required] 即可。我知道这不是c...
Swagger UI 不会在控制器的 GET 操作中呈现复杂类型参数的主体参数字段
我有一个 ASP.NET Web API 2 项目,我已向其中添加了 Swagger - Swashbuckle v5.6.0。一切正常。 Swagger UI 按预期呈现我的 API 的测试端点。 我添加了一个新控制器...
使用 SwaggerUI 和 nSwag 通过接受标头调用版本化端点
我有一个使用版本化端点的 ASP.NET Core 6.0 Web 应用程序。我选择使用 MediaTypeApiVersionReader,这意味着 api 版本在请求的接受标头中传递。 我是
IIS 重写,swagger ui 给出 404 未找到错误
我正在使用 Vue js 应用程序托管 Dotnet Core 3.1 项目。为此,我将 vue js 静态文件托管在 www-root 文件夹中。 我的应用程序中还有一个 swagger UI。 这是...
通过 Swagger UI 看到时如何将 FileUpload 响应正文视为上传按钮
我正在构建一个用于上传文件的 Quarkus REST API,我想在开发过程中使用 Swagger UI,以便在开发网站时拥有紧密的反馈循环。然而我正在努力争取
为什么 Swagger UI 在 Spring Boot 3.0 版本中不起作用?
我正在尝试运行我的 Spring boot 应用程序,该应用程序基于带有 swagger UI 的 3.0 版本,并且遇到了很多异常我已经探索了许多来源,例如 youtube 和文档,但我不...
我对占位符的描述有疑问,参数看起来重复且独立,如下图所示: 这是我的控制器: 这个控制器链接到一个se...
Swagger-UI 文档显示了使用 getComponent("operations") 自定义布局的示例。它位于 Swagger-UI 使用的组件列表中。这在 React 中工作得很好。然而,它不会...
对于我的 API,我正在制作一个元注释来处理 Pagable 参数,为此我需要将字符串列表注释为将显示在 Swagger UI 中的参数。 导入 io.swagger.v3.oas.
.Net Core Web Api 中的 Swagger UI 编码错误
我目前在 .Net Core API 项目中使用 swagger,但 swagger 生成的文档页面存在编码问题: 有谁知道如何解决这个编码问题?我试过看...
我正在尝试在项目中设置 OpenApi 文档。目前,我正在记录一个接收 DTO 并返回 DTO 作为响应的端点。 我的实体 DTO 有一个隐藏的私有字段...
我目前正在为我的 API 项目使用 OpenAPI 生成器,但遇到了一个意外问题。当我在 OpenAPI 规范中定义默认响应时,OpenAPI 生成器似乎...
Swagger UI 对于我们应用程序的每个 API 端点的“示例值”显示为“null”
我对应用程序的后端不太熟悉,但我正在尝试调查为什么我们的所有端点在应用程序的 Swagger 页面上都缺少“示例值”。 我们没有约定...
我的 swagger ui 有问题。我正在使用那些依赖项: org.springframework.boot 我的 swagger ui 有问题。我正在使用这些依赖项: <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>jakarta.xml.bind</groupId> <artifactId>jakarta.xml.bind-api</artifactId> </dependency> <dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <scope>runtime</scope> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-security</artifactId> </dependency> <dependency> <groupId>io.jsonwebtoken</groupId> <artifactId>jjwt</artifactId> <version>0.9.1</version> </dependency> <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-api</artifactId> <version>2.2.0</version> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-validation</artifactId> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> <dependency> <groupId>org.springframework.security</groupId> <artifactId>spring-security-config</artifactId> </dependency> </dependencies> 因此,如您所见,对于 swagger 我正在使用此依赖项 <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-api</artifactId> <version>2.2.0</version> </dependency> 这是我在 application.properties 中的 swagger 设置 # Swagger settings springdoc.swagger-ui.enabled=true springdoc.api-docs.path=/api-docs springdoc.swagger-ui.path=/swagger-ui.html 这是我的 SecurityFilterChain,我认为 Spring Security 可能会阻止我的请求,但看起来不应该 @Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http.cors().and().csrf().disable() .exceptionHandling().authenticationEntryPoint(unauthorizedHandler).and() .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS).and() .authorizeHttpRequests((requests) -> requests .requestMatchers("/api/auth/**").permitAll() .requestMatchers("/swagger-ui.html").permitAll() .requestMatchers("/api-docs/**").permitAll() .requestMatchers("/api/users/**").hasRole("USER") .requestMatchers("/api/admin/**").hasRole("ADMIN") .anyRequest().permitAll() ); http.authenticationProvider(authenticationProvider()); http.addFilterBefore(authenticationJwtTokenFilter(), UsernamePasswordAuthenticationFilter.class); return http.build(); } 我正在尝试通过此网址找到 swagger ui http://localhost:8080/swagger-ui.html 之后出现Whitelabel错误页面,但是 http://localhost:8080/api-docs 完美运作 那么问题出在哪里呢? 通常,如果您访问/swagger-ui.html,您将重定向到/swagger-ui/index.html,只需再添加一条路径以允许所有: .requestMatchers("/swagger-ui/**").permitAll()
Azure 函数:自动 OpenAPI 规范中的仅限日期参数
我正在使用 Microsoft.Azure.WebJobs.Extensions.OpenApi 在 .net 6 中创建一个进程内 Azure 函数,以启用自动 OpenAPI/Swagger 规范。 我需要发送一个日期(没有时间)作为...
只是学习 Maven 和 Spring Boot 的工作原理,所以我通过做简单的项目进行了一些练习。但我遇到了 swagger-ui.html 的问题,给出了 404 not found 错误。 什...