openapi 相关问题

无法在 Swagger 中使用内容类型应用程序/pdf 下载 pdf 文件

我有一个使用 Express 完成的端点，我在其中下载 pdf 文件作为缓冲区，设置： res.setHeader('内容类型', '应用程序/pdf') res.setHeader('内容处置', '附件; 文件名=

我应该将从 OpenApi 生成器插件生成的类映射到实体类吗

我已经定义了一个 openapi 规范，并且目前正在使用 openapi-generator-maven-plugin 从我的目标文件夹中的规范生成相关的类（模型）。我想知道

Spring 文档生成 OpenAPI 规范验证

我正在使用 org.springdoc:springdoc-openapi-starter-webmvc-ui 分别从我的控制器生成 openapi 规范和 swagger-ui 。 我没有使用 org.openapi.generator 来生成

是否可以使用 _data 文件夹进行提供程序测试，就像存根测试允许的那样

在运行提供程序测试（Spring Boot）API 时是否可以使用带有 json 示例的 _data 文件夹，就像使用存根测试一样？ 我有一个 quote-api.yaml 合同 源/

如何在 Python 中根据 OpenAPI3 规范验证 HTTP 请求？

似乎有许多 Python 库专门用于验证 OpenAPI 模式的正确性。虽然这可能有用，但坦率地说，我可以在 https://ed 中编写我的 OpenAPI 架构...

运行 OpenAPI 规范作为对实现它的应用程序的测试

我正在开发一种方法来验证 Spring Boot Web 服务是否遵守描述它的 OpenAPI 规范。 例如，如果 OpenAPI 中定义的端点

SpringDoc OpenAPi 中未禁用 petstore URL

我正在使用 SpringDoc 1.4.3 进行招摇。我添加了以下配置以禁用 application.yml 中的 petstore URL 配置 弹簧文档： 招摇用户界面： 禁用-swagger-默认-url：...

Petstore url（swagger 默认应用程序）在 Springdoc 中未禁用

我仍然有“禁用”问题...... 我的 swagger 界面 url 配置为 /swagger-ui.html （它重定向到 /swagger-ui/index.html?configUrl=/v3/api-docs/swagger-config => 这是

Swagger OpenAPI 给出带有路径变量的简单样式和模式类型对象的错误

我在我的项目中使用 swagger 请求验证器库（版本 2.22.0），并使用以下 yaml 配置。 信息： 标题：API 示例 版本：1.0.0 开放API：3.0.0 路径： /演示/{组标识符...

未提供API定义

错误 未提供 API 定义。 问题描述 我有一个 Spring Boot 应用程序，版本 3.2.5，我添加了以下依赖项： ...

将 swagger-parser 创建的 OpenAPI 对象序列化到规范文件

我正在尝试创建一个流程，该流程采用外部系统创建的 OpenAPI 规范文件，执行一些修改以使它们作为 Spring API 更好地工作，然后写入结果...

OpenApi 生成的接口方法的返回类型为 Object (Spring Boot 3)

我定义了一个 API 来注册用户。我想在用户注册成功后返回 SaveUserResponse。但是，gradle build后生成的接口的返回类型为Object。 哈...

OpenApi - oneOf - 类型是字符串而不是对象

我有一个 openapi 规范，其中一个对象只能包含 2 个 id 之一：type1 id 或 type2 id。这些 id 中的每一个都是字符串类型。官方文档展示了使用oneOf时refs的使用，

Echo 组无法使用使用 oapi-codegen 的 OpenAPI 生成的代码

我正在使用 oapi-codegen 生成我的服务器代码，并使用 Echo Labstack 作为服务器。 当我将 Group 实例而不是 Echo 实例传递给 Openapi.RegisterHandlers 时，我总是收到 400 错误......

未为 Azure Function 生成 OpenApi 文档

我有一个函数定义如下： 公共类注册函数（ IUserExistsQuery 用户ExistsQuery， IRegisterUserCommand 注册用户） { [函数（名称（注册函数））] ...

<Spring Boot / Springfox> Swagger UI 未显示示例值和模型

我使用 Springfox 从 Spring Boot REST 控制器生成 Swagger API 规范。 我注意到一个问题，无法显示示例值/模型以进行响应。 作为一项调查，我

多个@JsonTypeInfo和@JsonSubTypes

我知道 - 基于这里的不同问题： 多级@JsonTypeInfo和@JsonSubTypes， 使用多个级别的多态类型层次结构进行反序列化 在多重继承的情况下（Car<

如何使用@ArraySchema定义参数名称

我想使用spring和swagger来描述一个查询参数。 ReceiptStatus 是一个枚举。 我期望使用 @ArraySchema 中的 arrayschema 定义要解析为属性的属性...

如何修复代码生成中看似正确的“inputSpec”中的 OpenAPI 错误？

我正在尝试运行 OpenAPI 生成器，但我不断收到一条没有意义的错误消息。 无法执行目标 org.openapitools:openapi-generator-maven-plugin:5.0.0-SNAPSHOT:generate (

如何解决 OpenAPI Generator Maven 插件中的“reference to Type is ambigeous error”？

我的 openapi-generator-maven 插件配置如下 org.openapitools openapi-generator-maven-plugin 我的 openapi-generator-maven 插件配置如下 <plugin> <groupId>org.openapitools</groupId> <artifactId>openapi-generator-maven-plugin</artifactId> <version>7.1.0</version> <configuration> <generateSupportingFiles>true</generateSupportingFiles> <generatorName>spring</generatorName> <generateApiDocumentation>true</generateApiDocumentation> <generateModelDocumentation>true</generateModelDocumentation> <globalProperties> <skipFormModel>false</skipFormModel> </globalProperties> <!-- Duplicate classes being generated due to https://github.com/OpenAPITools/openapi-generator/issues/2701 --> <typeMappings> string+binary=StreamingResponseBody,ExpensePartnerConfig1=ExpensePartnerConfig,FeatureConfig1=FeatureConfig,Application1=Application,PaymentSourceInfo1=PaymentSourceInfo,CostCenter1=CostCenter,OAuthPartnerConfig1=OAuthPartnerConfig,DateTimeRange1=DateTimeRange,TmcInfo1=TmcInfo,Company1=Company,SupportConfig1=SupportConfig,RewardsProgram1=RewardsProgram,CompanyBasicInfo1=CompanyBasicInfo,UserPersonalInfo1=UserPersonalInfo,PnrData1=PnrData,Agent1=Agent,DocumentMetadata1=DocumentMetadata,Document1=Document,BasicTripInfo1=BasicTripInfo,VendorProgramPaymentDescriptor1=VendorProgramPaymentDescriptor,VendorProgramPaymentDescriptorWrapper1=VendorProgramPaymentDescriptorWrapper,WhiteLabelConfig1=WhiteLabelConfig,AirBookTravelerInfo1=AirBookTravelerInfo,UserGroup1=UserGroup,Question1=Question,PaymentSourceMetadata1=PaymentSourceMetadata,EventLocation1=EventLocation,EventUserRsvp1=EventUserRsvp,FormOfPayment1=FormOfPayment,PaymentSourceFilter1=PaymentSourceFilter,PaymentSourceTravelType1=PaymentSourceTravelType,PaymentSourceMappings1=PaymentSourceMappings,PaymentSourceMapping1=PaymentSourceMapping,PaymentSourceSpendType1=PaymentSourceSpendType,PaymentSourceAttributes1=PaymentSourceAttributes,LegalEntityFilter1=LegalEntityFilter,CompanyFilter1=CompanyFilter,CountryFilter1=CountryFilter,CostCenterFilter1=CostCenterFilter,PaymentSourceDepartmentFilter1=PaymentSourceDepartmentFilter,TravelerEventSummary1=TravelerEventSummary,AccessTypeAttributes1=AccessTypeAttributes,TravelTypeFilter1=TravelTypeFilter,PrivacyNotice1=PrivacyNotice </typeMappings> <importMappings> StreamingResponseBody=org.springframework.web.servlet.mvc.method.annotation.StreamingResponseBody </importMappings> <configOptions> <oas3>true</oas3> <useTags>true</useTags> <withSeparateModelsAndApi>true</withSeparateModelsAndApi> <delegatePattern>true</delegatePattern> <withInterfaces>true</withInterfaces> <library>spring-boot</library> <dateLibrary>java8</dateLibrary> <useSpringfox>false</useSpringfox> <useSpringController>true</useSpringController> <openApiNullable>false</openApiNullable> <modelPropertyNaming>camelCase</modelPropertyNaming> <useJakartaEe>true</useJakartaEe> </configOptions> <additionalProperties>removeEnumValuePrefix=false</additionalProperties> </configuration> <executions> <execution> <id>generate-client</id> <phase>generate-sources</phase> <goals> <goal>generate</goal> </goals> <configuration> <inputSpec>${project.basedir}/target/classes/generated/yaml/apis/api/Api.yaml </inputSpec> <generatorName>java</generatorName> <generateApiDocumentation>false</generateApiDocumentation> <modelNamePrefix>Spotnana</modelNamePrefix> <generateModels>true</generateModels> <generateApis>true</generateApis> <library>okhttp-gson</library> <configOptions> <library>okhttp-gson</library> </configOptions> <additionalProperties>removeEnumValuePrefix=true</additionalProperties> <output>${project.build.directory}/generated-sources/openapi/client</output> </configuration> </execution> </executions> </plugin> 我在生成过程中收到以下错误。有人可以建议我如何解决这个问题吗？ [ERROR] /Users/debrajmanna/code/java/github/spotnana/src/java/openapi-generator/target/generated-sources/openapi/client/src/main/java/org/openapitools/client/model/ServiceChargeRecord.java:[76,10] error: reference to Type is ambiguous both enum org.openapitools.client.model.Type in org.openapitools.client.model and interface java.lang.reflect.Type in java.lang.reflect match [ERROR] /Users/debrajmanna/code/java/github/spotnana/src/java/openapi-generator/target/generated-sources/openapi/client/src/main/java/org/openapitools/client/model/ServiceChargeRecord.java:[164,41] error: reference to Type is ambiguous 如错误消息中所述，您应该决定在 ServiceChargeRecord.java 类中导入哪一个。 要么： import org.openapitools.client.model.Type; 或者： import java.lang.reflect.Type;