openapi 相关问题

OpenAPI规范（最初称为Swagger规范）是用于描述，生成，使用和可视化RESTful Web服务的机器可读接口文件的规范。

未为 Azure Function 生成 OpenApi 文档

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

c# azure azure-functions openapi

回答 1 投票 0

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

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

java spring-boot swagger openapi springfox

回答 4 投票 0

多个@JsonTypeInfo和@JsonSubTypes

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

java jackson swagger openapi

回答 1 投票 0

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

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

spring swagger openapi

回答 1 投票 0

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

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

java jpa openapi openapi-generator

回答 2 投票 0

如何解决 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>  <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;

java swagger openapi openapi-generator swagger-codegen

回答 1 投票 0

如何使用FastAPI合并swagger文档？

我有两个 FastAPI 服务在不同的端口上运行：从 fastapi 导入 FastAPI 应用程序 = FastAPI() @app.get(“/测试”) 异步 def root(): return {"message": "你好，世界...

python swagger fastapi openapi swagger-ui

回答 1 投票 0

OpenAPI（Swagger）配置Quarkus

晚安。我是 Quarkus 的新手，我正在通过 OpenApi 配置 swagger，但是我对其配置有疑问，例如我通过对象组合来处理请求/响应，

java swagger openapi quarkus

回答 2 投票 0

如何在 Node.js 中设置 OpenAPI 3.0.0、Swagger UI 的 basePath

我的控制器中有带有内联 openAPI 注释的路由器。 API 工作正常，但端点的 swagger URL 未附加基本路径，因此我收到 403 禁止...