问题标签 [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.
json - Swagger 如何编码 JSON?
我以 json 编码的关联数组的形式获得响应,其中包含布尔、整数和字符串类型的 3 个元素。
这就是答案的样子:
{"成功":true,"code":200,"msg":"\u0423\u0441\u043f\u0435\u0445!"}
但我不明白如何解码 msg 元素。提示?
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 ", }),这是意外并导致问题的原因。
我尝试使用以下插件生成存根。两种情况下生成的接口都有相同的问题。
openapi-generator-maven-plugin
org.openapitools openapi-generator-maven-plugin 4.2.3
swagger-codegen-maven 插件
io.swagger.codegen.v3 swagger-codegen-maven-plugin 3.0.11
使用的弹簧靴版本:2.2.2.RELEASE
spring-boot - 如何为同一项目的不同api创建两个不同的链接
是否可以有两个不同的招摇链接来显示不同的 api?例如:
链接 1 显示允许您创建和编辑用户的方法 链接 2 仅显示编辑
这可以使用 swagger 3 吗?
api - Swagger - 将内容显示为文本
我有一个返回 tar 文件的端点。当我在邮递员中对其进行测试时,它工作正常,并且下载了 tar 文件,但是随着大摇大摆,我得到了以下错误
这是我招摇的端点代码
spring-boot - Swagger UI 3.0 中未显示文件上传参数
我正在使用springboot应用程序中的注释创建swagger文档,所有API参数都在工作而不是文件参数,文件参数没有显示在swagger UI中。它也没有在与文件属性相关的日志中给出任何错误。
下面是用于显示文件参数的注释。
我也改变了paramType="formData"
,但文件属性仍然没有出现。任何帮助将不胜感激。大摇大摆 = v3.0
spring-boot - @RequestPart 注释未显示必需的符号
我正在使用下面的注释在 swagger-ui 上显示多部分文件属性,它工作正常。但是问题开始于我需要在 swagger-ui 上显示文件属性的必需(*)符号。
这是我使用 @RequestPart 注释的方式。
@RequestPart(value = "file", required=true) 最终的多部分文件
但是没有应用必需的属性,请建议如何使用 @RequestPart 注释在任何属性上添加必需的符号。
swagger - 我们可以从 OpenApi 中删除默认响应状态吗?
OpenAPI 向 API 添加默认响应,但我想向不同的 API 添加不同的响应。我正在为每个 API 使用
但是在 Swagger UI 中,我得到了200
, 201
, 400
, 401
, 403
, 404
, 409
,500
所有这些响应代码。我只想得到我在注释200
中定义201
的那些。401
403
@ApiResponses
spring-boot - Swagger 3 必需的全局请求参数
我正在使用带有 Swagger 3 的 Spring Boot 2.5.4。我在 Swagger 配置文件中添加了一个全局请求参数作为类型标头和 required=true。Swagger UI 在所有 API 中正确显示所需的请求标头,但问题是它允许在所需请求标头的值为空时发送请求。在 Swagger 2 中,UI 用于禁用发送请求,直到值被填充。
有什么建议么。