openapi 相关问题

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

“RouteHandlerBuilder”不包含“WithOpenApi”的定义

我正在查看此文档:https://learn.microsoft.com/en-us/azure/azure-sql/database/azure-sql-dotnet-entity-framework-core-quickstart?view=azuresql&tabs=视觉工作室%2Cservice-

回答 1 投票 0

FastAPI - 生成 OpenAPI.json 后将其切换 - 在哪里放置代码?

FastAPI 生成“openapi.json”文件并为其提供接口。 为了进行实验,我需要将其替换为第三方文件。 从 pathlib 导入路径 导入 json 应用程序。

回答 1 投票 0

如何使用Poem访问请求组件

我正在尝试访问与我的诗歌服务器收到的请求相关的标头、url 路径、查询参数和其他 http 信息。 服务器使用poem-openapi和tokio来接收和

回答 1 投票 0

openapi中如何设置默认的API定义url?

我想通过 url /v3/api-docs/ 设置默认方案,但有空 url 和错误“未提供 API 定义。”。 我应该使用哪些设置属性? 项目中的当前代码: 申请。

回答 7 投票 0

如何比较两个 OpenAPI / Swagger json API 文档之间的路径、定义、参数和响应?

我想知道是否有一个解决方案可以帮助查找同一产品的两个不同 API 版本(Swagger/Open API 2.0)之间的差异。比如这个工具:https://gi...

回答 1 投票 0

多个响应正文示例取决于 OpenApi 3.0.0/Swagger 中的媒体类型

我正在尝试记录接受多个 mime 类型请求并根据类型返回不同响应的端点的响应。一种响应类型 PDF 返回其自己的模式分隔...

回答 1 投票 0

如何用OpenAPI(Swagger)语法描述嵌套的请求体?

我需要用OpenAPI(Swagger)语法来描述REST(JSON)API。当我需要描述嵌套请求主体时,我陷入了困境。请建议如何制作,让我们以下一个为例......

回答 1 投票 0

Spring Boot 3.2.4 + Springdoc OpenAPI:“规范中没有定义操作!”在 Swagger UI 中

我正在开发 Spring Boot 应用程序(版本 3.2.4)并使用 Springdoc OpenAPI(版本 2.0.4)生成 API 文档。但是,当我打开 Swagger UI 时,我看到消息“No opera...

回答 1 投票 0

Swagger/OpenAPI 3.0 RequestBody 描述未显示

我正在 Swagger 中创建 API 文档。我直接尝试了openapi 3.0。不知怎的,我无法让我的请求主体的描述发挥作用。 请求正文: 内容: 申请/x-www-form-

回答 1 投票 0

有没有办法将测试文件导入到redoc x-codeSamples源字段中?

重做指南指定使用原始文本作为代码示例中的源: https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md#x-codeSamples 像这样: 语言:JavaScript 来源:con...

回答 1 投票 0

如何让填充按钮填充RapiDoc中的默认值并让有人使用这些值来尝试?

我有一个用于 API 文档的 RapiDoc,清除按钮和尝试工作正常,但我希望当有人需要尝试时,他们不应该将值放入字段中,而是通过

回答 1 投票 0

使用现有的枚举,无需在 Spring Boot 中通过 OpenAPI 代码生成器重新生成它们

我有一个 YAML 文件,我想通过 OpenAPI 代码生成器(openapi-generator-maven-plugin)生成该 YAML 文件的等效类。我的 YAML 文件是这样的: 佩纳皮:3.0.3 信息: ...

回答 1 投票 0

oasdiff --err-ignore 标志不忽略

有人知道如何创建这个忽略文件吗?文档不清楚,它基本上说只在其中写入端点。 所以运行 oasdiff 后破坏我的输出是这样的 呃...

回答 1 投票 0

OpenAPI:从 requestBody 和响应中的组件架构引用

是否可以在OpenAPI中的requestBody或response中引用对象的属性? openapi: '3.0.2' 路径: /登录: 邮政: 摘要:登录用户 请求正文: 内容...

回答 2 投票 0

可重复的 Swagger/OpeanAPI 元注释的别名

我有一个REST控制器,其中每个方法都带有Swagger的@ApiResponse注释,用于多个响应代码。对于 HTTP 200 响应代码,每个模式的实现都不同

回答 1 投票 0

Openapi 类型生成问题“未定义 fetch”

我使用 openapi-typescript-codegen 包从 Spring Boot 后端的 swagger 端点生成类型。该命令之前运行良好,但在我们由于漏洞更新内容之后

回答 2 投票 0

OpenApi:为requestBody和response添加对象属性

是否可以在OpenAPI中的requestBody或response中引用对象的属性? openapi: '3.0.2' 路径: /登录: 邮政: 摘要:登录用户 请求正文: 内容...

回答 1 投票 0

是否可以强制 NSwag 为 ASP.NET MVC 控制器(不是 ApiController!)生成 OpenAPI 架构/SwaggerUi

我根据官方 wiki 使用 GlobalAsax.cs(.NET Framework)对 ASP.NET MVC 项目进行了非常基本的设置。 由于某些原因,我必须使用 MVC 控制器(System.Web.Mvc.Controller

回答 2 投票 0

限制OpenAPI规范中返回的模型

使用 ApiDeclarationFilter 我们可以从 openapi 规范中删除路径,而无需从元数据中删除它(例如 /types/typescript)。 SchemaFilter 允许浏览......中的模型

回答 1 投票 0

OpenAPI 3.0 如何将 dto 字段显示为查询参数

我正在从 Swagger 2.x 迁移到 OpenAPI 3.0,并遇到了一些麻烦:我使用 ApiModel 和 ApiModelProperties 将 dto 字段显示为方法的参数,但现在它只显示...

回答 1 投票 0

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