openapi 相关问题

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

get_swagger_ui_html 导致 FastAPI 应用程序中显示不需要的服务器选项

我需要更改样式并向 FastAPI 应用程序中默认生成的文档添加额外的 HTML,因此我使用 get_swagger_ui_html 来实现此目的。这会导致操作级别选项为“S...

回答 1 投票 0

多应用环境中的OpenAPI管理

在一个项目中,我们有多个应用程序,其中(几乎)每个应用程序都提供自己的并使用其他 openapiAPI 规范文件。现在每个应用程序都有一份提供和使用的 openAPI 规范文件的副本

回答 1 投票 0

Swagger url 生成的 json 缺少“securityschemes”组件

我生成的 swagger.json 缺少 securitySchemes 组件。当我复制 url json 并将其粘贴到 swagger 编辑器中时,我得到 - 在此输入图像描述 swagger.json 中生成的 yaml ...

回答 2 投票 0

覆盖 io.swagger.v3.oas.annotations.media.Schema 中的任何参数都会引发异常

我有这个开放API注释 @得到 @Operation(method = "获取订单", description = "GetOrdersRoute", 参数={ @参数(in =

回答 3 投票 0

从 Azure Function 进程外模型中的 swagger.json 路径中删除 /api

我使用以下路由定义了一个端点: /api/{id} 这会干扰标准的 swagger.json 路径,最终成为 /api/swagger.json 我想配置所有 swagger URL,所以...

回答 1 投票 0

Quarkus Openapi 扩展:在构建时获取生成的 openapi yml 文件

为了生成客户端库,我会在构建时获取 Quarkus 生成的 openapi yml 文件。 目前我发现获取它的唯一方法是运行服务器并从 /q/openapi 获取它

回答 2 投票 0

Javalin OpenAPI 注释遇到“未提供 api 定义”错误

我正在开发一个 Javalin 项目,尝试使用 OpenAPI 注释来记录我的 REST API。尽管用 @OpenApi 注释了我的控制器方法,但我遇到了“没有 api 定义

回答 1 投票 0

OpenApi 3.0 显示所有 HTTP 方法

我的 OpenApi 疯了...我创建了 2 个简单的 REST API @RequestMapping("/inWithHibernate") @PutMapping 公共无效inDbMobile(){ hibernateInsert.inDB(); } @

回答 2 投票 0

如何在 Swagger 中描述具有简单对象的数组的模型?

我有一个 REST 服务要记录, 其中一些接受简单的数组,例如: [ {“名称”:“a”}, {“名称”:“b”}, {“名称”:“c”} ] 我如何在 Swagger 模型部分描述这一点?我只能...

回答 7 投票 0

如何在 OpenAPI 中定义多个响应主体模式

我们有一个带有 json 响应的端点,如代码 1 中所示。有一个用户条件,当满足此条件时,会添加第二个版本的 json,并添加字符串“Employee”,如 Code2 中所示。 我正在尝试记录...

回答 1 投票 0

如何在 swagger 中将根标签包装到现有端点

我们有一个带有 json 响应的端点,如代码 1 中所示。有一个用户条件,当满足此条件时,会添加第二个版本的 json,并添加字符串“Employee”,如 Code2 中所示。 我正在尝试记录...

回答 1 投票 0

仅从 API 生成一个特定端点

我当前在 build.gradle 中对 OpenAPI 生成器的设置。 def openApiGeneratorConfig = { 类路径配置.openApiGenerator systemProperties = ["apis": "", "莫...

回答 1 投票 0

在生成过程中用外部 Rust 值替换 openapi 模式中的模型

我有一个服务器的 openapi 规范,其中一个端点返回一个 Thing 列表,但 Thing 是从不同 openapi 规范生成的极其复杂且大型的对象。这不是

回答 1 投票 0

Rust诗歌-openapi:多个文件中的端点

我正在尝试构建具有多个端点的 REST API。某些端点之间的相关性可能比其他端点更多,因此我想在多个文件中实现它们。我有一种

回答 1 投票 0

如何使用openapi-generator生成元数据信息

在我的 openapi.yaml 文件中,我想在代码中访问一些信息。 开放API:“3.0.0” 信息: 标题: 标题 描述:我的描述 版本:“1.0” 现在我...

回答 1 投票 0

如何定义具有任意键但固定值类型的对象?

当键可以是任何值但始终是特定格式且对值有类似要求时,您将如何在 OpenAPI 3.x 中定义对象? 例如下面的结构 键值:{&q...

回答 1 投票 0

尝试使用Swagger 2.0版本(不是谈论OpenAPI)

我从同事那里继承了一个项目,它是一个使用 Visual Studio 2022 的 ASP.NET Core 构建的简单 REST API。它使用的 Swagger 版本是 1.0,带有 OpenAPI v3.0.1。我想要 Sw...

回答 1 投票 0

获取“规范中未定义操作!”对于 SpringDoc Swagger

我已经使用 OpenAPI 库实现了 swagger。 我的应用程序在 spring boot 2.7.1 上运行 我收到“规范中没有定义操作!”,甚至我的控制器也有 api。可能是什么...

回答 1 投票 0

如何从 Spring Cloud Gateway 服务自定义 SpringDoc OpenApi 定义

我想为我的每个 OpenApi 服务添加安全架构。 我尝试 `@配置 公共类 OpenApiConfig { @豆 公共 GroupedOpenApi api(OpenApiCustomizer openApiCustomizer) { 返回

回答 1 投票 0

扩展 OpenAPI (Swagger) 编辑器不适用于 Macbook Air M2

我在 Macbook Air M2 上安装了扩展 OpenAPI (Swagger) Editor,但没有看到此扩展。 VS版本:1.64.1(通用) 我也没有在 OPENAPI 选项卡上看到任何内容 重新启动VS并重新安装...

回答 1 投票 0

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