问题标签 [swagger-3.0]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
53 浏览

json - Swagger 如何编码 JSON?

我以 json 编码的关联数组的形式获得响应,其中包含布尔、整数和字符串类型的 3 个元素。

这就是答案的样子:

{"成功":true,"code":200,"msg":"\u0423\u0441\u043f\u0435\u0445!"}

但我不明白如何解码 msg 元素。提示?

0 投票
0 回答
27 浏览

spring-boot - 从 swagger codegen 插件生成的界面中的 Produces 属性有一个额外的值“result”

我们目前正在构建一个简单的 Spring Boot 微服务。该微服务的功能是调用另一个下游服务并返回响应。下游服务使用 OPEN API 3.0 swagger 构建,我的微服务使用 swagger 2.0。

在这里,我尝试使用相同的 swagger codegen 插件为两个 swagger 生成存根。

问题 :

swagger codegen 生成的接口在produces 属性中有一个额外的值(produces = { "application/json", " result ", }),这是意外并导致问题的原因。

我尝试使用以下插件生成存根。两种情况下生成的接口都有相同的问题。

  1. openapi-generator-maven-plugin

    org.openapitools openapi-generator-maven-plugin 4.2.3

  2. swagger-codegen-maven 插件

    io.swagger.codegen.v3 swagger-codegen-maven-plugin 3.0.11

使用的弹簧靴版本:2.2.2.RELEASE

0 投票
0 回答
36 浏览

spring-boot - 如何为同一项目的不同api创建两个不同的链接

是否可以有两个不同的招摇链接来显示不同的 api?例如:

链接 1 显示允许您创建和编辑用户的方法 链接 2 仅显示编辑

这可以使用 swagger 3 吗?

0 投票
0 回答
40 浏览

api - Swagger - 将内容显示为文本

我有一个返回 tar 文件的端点。当我在邮递员中对其进行测试时,它工作正常,并且下载了 tar 文件,但是随着大摇大摆,我得到了以下错误

这是我招摇的端点代码

0 投票
2 回答
214 浏览

java - Java Spring Boot openApi Swagger 如何填充首页入口字段

Swagger UI 在其页面顶部有一个输入字段。我猜这个页面是文档的链接。这个对吗 ?我怎样才能改变这个值?我已经知道/V1是从 application.yaml 中检索到的。

在此处输入图像描述

0 投票
0 回答
70 浏览

swagger - swagger3 无法为列表参数输入多个值

spring boot 2.x,我添加springfox-boot-starter 3.0.0@EnableOpenApi使用 swagger3。

我有以下控制器

但是,对于List<Integer>swagger 中的参数,它是整数而不是数组/列表,它看起来像:

在此处输入图像描述

它应该是多个输入,这样我就可以为数组/列表输入多个值,对吧?

如何list在 swagger3 中输入多个值?如果我在一个输入中键入多个用逗号分隔的值,swagger3 会给我错误提示。

0 投票
0 回答
51 浏览

spring-boot - Swagger UI 3.0 中未显示文件上传参数

我正在使用springboot应用程序中的注释创建swagger文档,所有API参数都在工作而不是文件参数,文件参数没有显示在swagger UI中。它也没有在与文件属性相关的日志中给出任何错误。

下面是用于显示文件参数的注释。

我也改变了paramType="formData",但文件属性仍然没有出现。任何帮助将不胜感激。大摇大摆 = v3.0

0 投票
0 回答
130 浏览

spring-boot - @RequestPart 注释未显示必需的符号

我正在使用下面的注释在 swagger-ui 上显示多部分文件属性,它工作正常。但是问题开始于我需要在 swagger-ui 上显示文件属性的必需(*)符号。

这是我使用 @RequestPart 注释的方式。

@RequestPart(value = "file", required=true) 最终的多部分文件

但是没有应用必需的属性,请建议如何使用 @RequestPart 注释在任何属性上添加必需的符号。

0 投票
0 回答
37 浏览

swagger - 我们可以从 OpenApi 中删除默认响应状态吗?

OpenAPI 向 API 添加默认响应,但我想向不同的 API 添加不同的响应。我正在为每个 API 使用

但是在 Swagger UI 中,我得到了200, 201, 400, 401, 403, 404, 409,500所有这些响应代码。我只想得到我在注释200中定义201的那些。401403@ApiResponses

0 投票
1 回答
47 浏览

spring-boot - Swagger 3 必需的全局请求参数

我正在使用带有 Swagger 3 的 Spring Boot 2.5.4。我在 Swagger 配置文件中添加了一个全局请求参数作为类型标头和 required=true。Swagger UI 在所有 API 中正确显示所需的请求标头,但问题是它允许在所需请求标头的值为空时发送请求。在 Swagger 2 中,UI 用于禁用发送请求,直到值被填充。

有什么建议么。