Swagger是一个框架实现，用于基于Open API规范描述，生成，使用和可视化RESTful Web服务
在 Spring 中托管手动制作的 openapi.yaml 规范的最佳方式
环顾四周寻找这个答案，我只找到了如何从代码生成和托管 openapi 规范，而不是相反。 我们创建了一个 .yaml 文件，其中包含我们所有的 api 规范....
Swagger ui 不加载函数http触发器和nestjs
我正在尝试为我的azure http触发功能配置swagger，但是当我在浏览器中查询定义swagger的路径时，一些请求处于待处理状态，如下图所示。我...
在 POST 中使用 JAX-RS `@DefaultValue` 作为 bean 属性
我有以下 JAX-RS 资源： @邮政 公共响应createPerson（最终用户用户）{ // ... } 用户 bean 是： 公共类用户{ 受保护的字符串姓氏； 受保护的字符串 r...
在我的 Net 6 Web-API 项目中，我使用 OData 和 Swagger（它是在创建项目时自动添加的）。 它开箱即用，但 Swagger 生成的某些 URL 存在问题。 他...
我想通过dynamoDB创建表User，并具有一些由swagger设计的属性： 用户{ id（字符串，可选）：用户的UUID， 名称（字符串，可选）， lastLoginedAt（字符串，可选），...
如下图所示，即使开放 API 中存在最大长度和最小长度，Azure APIM 的开发人员门户中的请求也只能看到四列......
为了学习 Auth0，我克隆了他们的示例词汇表项目并将其升级到 net8 net8.0 为了学习 Auth0，我克隆了他们的示例 glossary 项目并将其升级到 net8 <Project Sdk="Microsoft.NET.Sdk.Web"> <PropertyGroup> <TargetFramework>net8.0</TargetFramework> <UseAppHost>false</UseAppHost> </PropertyGroup> <ItemGroup> <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="8.0.11" /> <PackageReference Include="Swashbuckle.AspNetCore" Version="7.1.0" /> </ItemGroup> </Project> 我还添加了一个.sln 当我跑步时，我看到了 swagger ui 我在 Auth0 中设置了 api，并使用应用程序来使用它。 该应用程序已检查权限。 在我已经放入的应用程序设置中 "Auth0": { "Domain": "myoauthtenant.au.auth0.com", "Audience": "https://glossary.com", "ClientId": "GS9.. etc", "ClientSecret": "BYl2.. etc" } 我尝试使用 OAuth0 api 中的“测试”选项卡和 OAuth0 应用程序中的“测试”选项卡创建令牌 我还在 GitHub 上提出了我的问题。 我的 API 在我的测试应用程序中获得了授权 我从“测试应用程序快速启动”选项卡复制不记名令牌并将其粘贴到 Swagger 授权输入中 然后尝试发布 授权文件在这里。 据我所知，该项目也应该在 .NET 8 中运行。 恐怕您正在混合配置 API 和 OAuth 客户端应用程序的说明。例如，您不需要 ClientId 中的 ClientSecret 和 appsettings.json 来配置 API。 按照本文中的说明测试 API（顺便说一下，这是该示例项目附带的文章）
虽然这里对这个主题有很长的讨论：https://github.com/swagger-api/swagger-ui/issues/156 我还没有找到一种更干净的方法来“有选择地”禁用“试用”按钮。 我想要
如何在 Dotnet API 中接收 Enum 作为字符串？
我有一个用 swagger 记录的 dotnet API 应用程序。在我的一个端点中，我收到如下 DTO： 公共类 CreateCooperativeUserDTO { [必需的] 公共必需字符串名称 {...
如何在 Spring Boot 3.4 项目中实现 swagger ui [已关闭]
过去两年我使用 Springfox 开发 Spring Boot 应用程序。 Springfox 为您的 REST API 生成文档和测试 ui。 但实际上 Springfox 项目已经死了并且不支持
在 Spring Boot 3 中的 Swagger 3.0 中配置 Jwt 令牌
我正在使用 Spring Boot v3.0.2 应用程序作为我的后端，并且我正在尝试将 Swagger v3.0 与我的应用程序集成以用于 api 文档目的。我已经成功配置了 swa...
我正在构建一组 API 和 Webhook。对于常用的 API，我可以毫无问题地编写 YAML 文件来在 Swagger 中记录它。不过，我还想记录一下 webhook，例如它们的 r...
为什么 springdoc-openapi 在按照开箱即用的描述组装时不会返回 api 文档？
当我尝试在一个有很多移动部件的应用程序中从 springdoc 检索 api-docs 时，我遇到了错误 404。为了调试问题，我构建了一个简单的 springboot 应用程序，其中只有......
如何在Spring boot中同时使用@RestControllerAdvice和Swagger UI
我有一个非常简单的 Spring boot 项目，包含 Swagger UI： org.springdoc springdoc-openapi-starter-webmvc-ui 我有一个非常简单的 Spring boot 项目，包含 Swagger UI： <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId> <version>2.5.0</version> </dependency> 在我设置一个类有@RestControllerAdvice之后，尝试查看 swagger UI 会抛出异常： 日志是 java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.<init>(java.lang.Object)' 树： └───com └───cuong02n └───test │ App.java │ ├───controller │ CourseController.java │ StudentController.java │ └───exception CustomExceptionHandler.java <-- The @RestControllerAdvice here StudentException.java 阅读并通过添加 basePackage 尝试一些解决方案后，我仍然无法访问 Swagger UI。 更新 pom.xml is： <?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>3.4.0</version> <relativePath/> <!-- lookup parent from repository --> </parent> <groupId>com.cuong02n</groupId> <artifactId>test-controller-advice-swagger</artifactId> <version>0.0.1-SNAPSHOT</version> <name>test-controller-advice-swagger</name> <description>test-controller-advice-swagger</description> <properties> <java.version>17</java.version> </properties> <dependencies> <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId> <version>2.5.0</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> </dependencies> <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build> </project> 根据@M.Deinum，这是由于不兼容而导致的，我正在使用 spring-boot-starter-parent 3.4.0 和 springdoc-openapi-starter-webmvc-ui 2.5.0。他们很矛盾。 我的解决方案是将 spring 降级到 3.3.5，效果很好。
对于我们的 AWS API 端点，我们使用 AWS_IAM 授权并希望从 Swagger UI 进行调用。 要成功调用，必须有 2 个标头“Authorization”和“x-amz-date”。形成“作者...
我正在使用 Jakarta REST（以前称为 JAX-RS）的 quarkus-rest 实现开发 REST API。我还使用 quarkus-smallrye-openapi 扩展来生成我的 API 规范 (OpenAPI v3)。 ...
如何将 JSON 文件（从 Swagger）导入到 Karate Labs？
目前我们有来自 Swagger / Swashbuckle 的 API 端点信息。 是否可以将 Swagger JSON 文件导入 Karate Labs 以实现端点自动化？ 先感谢您！ 我做了一些研究...
我们有一个SpringBoot（版本1.5.12）REST Api，带有springfox-swagger2和springfox-swagger-ui（版本2.9.2） Swagger UI 中是否可以有可为 null 的属性（使用 swagger.yaml 配置...
简介 当您使用 FastAPI 创建 API 时，FastAPI 可以自动生成您的文档。 我正在尝试在我的一个端点的描述（降价）中插入图像，但我不能......
我希望api能够接受多个查询字符串，例如： GET /{id}?expand=属性1,属性2 我将 api 定义为： 公共任务 GetAsync（[FromRoute] st...