swagger 相关问题

Swagger是一个框架实现,用于基于Open API规范描述,生成,使用和可视化RESTful Web服务

Swagger 编辑器导入规范和外部参考

我正在使用 swagger 编辑器,并已将 openapi 规范作为 yaml 导入,但由于所有外部引用而显示错误 - $ref: '#/components/parameters/orgIdPathParam' 这指向

回答 1 投票 0

承载安全定义未显示 Swagger .NET 8

我正在设置一个新的.NET 8 API,使用 Identity 来处理身份验证过程。 我在大肆设置不记名令牌身份验证时遇到问题。 所以环顾四周后我想到了......

回答 1 投票 0

如何在开放 API 规范中为字符串类型的属性指定空字符串值作为默认值

我有一个打开的 api yaml 文件,如下所示。我想将空字符串值指定为字符串类型属性的默认值。有什么方法可以做到这一点 测试: 类型:对象 必需的: ['', ''] 特性: 测试...

回答 2 投票 0

如何将 Springdoc Swagger UI 指向我自己的 YAML 文件而不是自动生成的文件?

我创建了一个 Spring Boot RESTFul 微服务,对于文档,我创建了一个 swagger.yaml 文件,但我不知道如何运行该文件。为了创建 swagger.yaml 文件,我使用了 O...

回答 2 投票 0

当 API 中未发送必填字段值时,如何在 swagger 中自定义错误消息?

下面是我的api.yml: 开放API:3.0.0 信息: 标题:“自动送货 API” 描述:“自动投递 API 文档” 服务条款:'https://www.yopmail.com' 接触: 名称:

回答 4 投票 0

在 Swagger UI 中通过外部化 Open API 提供授权按钮

假设我有一个从其他地方检索开放 API 的服务器。如何在 Swagger UI 中启用授权按钮?我所需要的只是能够传递 JWT 作为授权请求标头...

回答 1 投票 0

如何在 Nodejs 应用程序的 swagger 中对端点进行分组

在 NodeJS 中,分组 API 对我来说是不可能的。看到的各种方法并没有像预期的那么简单;因为端点仍然保持默认的 swagger 分组。下面的方法使得

回答 1 投票 0

使用 python Flask-Restful+apispec+marshmallow 时如何设置字段示例值?

我正在使用 Flask 创建一个 Web 应用程序。我想用 swagger 生成一个 API 参考文档。 库:Flask-Restful、apispec、marshmallow(也可能是 webargs) 我能够大摇大摆

回答 1 投票 0

为什么我的 ReadyAPI Swagger 合规性断言失败

我们正在构建一堆 API,但在测试它们时遇到了一个奇怪的问题。 在我们的 swagger 文件中,我们有以下内容: “客户地址”:{ “类型”:“对象”...

回答 1 投票 0

隐藏标题以防止在 Swagger Swashbuckle 中显示

由于我已经添加了通用授权,如何从每个 API 中删除单独的(授权标头),如下图链接所示? swaggerHub_链接

回答 1 投票 0

Springdoc/Swagger:微米跟踪未传递到下游。需要没有 RestTemplate 的解决方案

与这里的问题类似:Micrometer Tracing traceId not pass into下游 我使用的是 Spring boot 3.1,我的下游使用的是 2.7.x。我们使用 openapi 生成器来实现我们的业务逻辑,并且不做...

回答 1 投票 0

nestjs,swagger DTO 扩展

我的回应类型之一 导出类 VoucherDto { @ApiProperty({ 示例: 'fff', 必需: true, 描述: '' }) 名称!:字符串; @ApiProperty({ 示例: 'fff', 必需: false, 描述...

回答 1 投票 0

OpenAPI/Swagger 中如何指定某个字段是可选字段还是必填字段?

如何在 OpenAPI/Swagger 中定义字段是可选字段还是必填字段以及默认字段是什么?

回答 4 投票 0

寻找通过 docker 在 M1 Mac 上运行 swagger-codegen-cli 的解决方法

我尝试在 M1 Macbook 上通过 docker 运行 swagger-codegen-cli,但它要么无法运行,要么陷入无限循环(在不同的 Macbook 上测试)。 我发现目前没有

回答 1 投票 0

如何在 NestJS/Swagger 中禁用特定控制器方法的安全性?

我正在使用 NestJS 和 Swagger 模块来生成等效的 API 规范。 有没有办法禁用特定控制器方法的安全性,同时将控制器类标记为需要

回答 3 投票 0

openapi-generator 生成空接口

我正在尝试为后端服务的API生成TS存根。我的问题是它生成了一个空接口,我无法在我的 TypeScript 代码中使用它...... 这是规格: { “比较...

回答 1 投票 0

如何在 OpenAPI 中定义枚举映射?

我正在设计一个 API,我想定义一个枚举 Severity,其值可以为 LOW、MEDIUM 或 HIGH。在内部,严重性存储为整数,因此我想将它们分别映射到 2,1 和 0...

回答 2 投票 0

如何在 hapi-swagger 文档页面上进行身份验证,以便只有真实的用户才能看到我的文档

我正在使用 hapi-swagger 制作 API,并且我已经实现了基本身份验证。但即使用户没有身份验证,他仍然可以查看我的文档页面。我想阻止他看到...

回答 3 投票 0

如何在 AspNetCore 中定义 OpenApi 的文件响应

我正在 AspNet Core 5 中编写一个控制器方法,该方法应该以流的形式返回文件。 [http获取] [路线(“/docs/{id}”)] [产生响应类型(StatusCodes.Status200OK)] 公共异步任务<

回答 2 投票 0

如何使用codegen-openapi生成的RTK查询API来操作每个端点的查询路径?

在我们的应用程序中,我们想要使用 Redux Toolkit Query,并根据后端的 swagger 定义自动生成 API 定义。 我们的后端由多个微服务组成,每个微服务

回答 1 投票 0

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