我有一个用swagger和openAPI 3.0编写的swagger文档。在生成的请求(以及响应)文档中，它将"Example Value“和"Schema”显示为选项卡，您可以从中进行选择。有没有办法将"Example Value“和<
浏览 117提问于2020-08-27得票数 1
我正在开发一个API，允许使用URL进行搜索，如下所示： GET https://example.com/api/data?search[field1]=value1GET https://example.com/api/data?search[field1]=valu
浏览 49提问于2019-05-23得票数 1
回答已采纳
2回答
Swagger2.0支持JAX规范的矩阵参数吗？我的应用程序中有一些矩阵参数，如/map/color;lat=50;long=20;scale=32000。我想导出矩阵参数的Swagger。我使用，但在编辑器中得不到任何帮助。有谁可以帮我？与矩阵param有关的其他链接：
浏览 0提问于2016-03-11得票数 5
回答已采纳
1回答
我一直试图根据向Swagger添加示例(请参阅请求和响应正文示例的最后代码库)，但它似乎不像预期的那样工作。考虑到以下最起码的例子：info: version: "1"paths: description: It worked application/json:
浏览 2提问于2018-10-11得票数 1
回答已采纳
下面是我尝试在team中添加前端Swagger文档时遇到的问题。在我最初的Swagger文档(Swagger2.0)中，在前面提到的响应体path下面有一个字段： '200':
description: Success虽然我也尝试输入OpenAPI 3.0文档，但我在正式文档之后重
浏览 0提问于2019-09-03得票数 3
我在swagger中遇到了一个非常奇怪的bug。Please indicate a valid Swagger or OpenAPI version field.Supported version fields are swagger: "2.0" and those that
match openapi: 3.0.n (for example, openapi将返回此错误的示例
浏览 20提问于2020-05-19得票数 0
在我的Swagger规范文件中，我想返回示例响应，因此我可以在响应中添加examples。但是这使得我的spec文件非常大并且容易出错。有没有办法引用包含示例对象的JSON的文件？type: integer responses: description: Taxable Entities type: file
浏览 0提问于2016-12-30得票数 4
有没有办法在swagger中使用camel-swagger-java或camel-openapi-java模块将特定端点标记为已弃用？查看openapi v2 specification时，可以在文档中添加"deprecated: true“属性以弃用和终止，但我找不到使用camel swagger或camel openapi实现这一点
浏览 68提问于2021-04-26得票数 0
因此，我希望在不降低swagger库版本的情况下生成swagger 2.0YAML文件(api端点已经使用swagger 4.x - openapi 3.0规范进行了描述)。Nestjs和swagger依赖项(package.json)： ...和swagger生成器脚本： import { NestFactory } from '@nestjs/core';
import { AppM
浏览 42提问于2020-06-19得票数 2
回答已采纳
我使用来设计API，并得到一个错误，我不知道如何解决：info: version: '1.0' responses:
浏览 3提问于2017-08-07得票数 56
回答已采纳
1回答
app.pyfrom flasgger import Swagger
Swagger(appresponses: description: A list of colors (may be filtered by palette) $ref: '#/components/schema</
浏览 18提问于2021-12-15得票数 1
我已经设置了一个Swagger文档，它在UI中看起来没问题。但是，当我使用“试用”功能时，我收到以下错误：我的Swagger文档的相关部分如下所示： type: string - name: description
in:example
浏览 38提问于2018-03-06得票数 1
回答已采纳
有大量关于Spring Boot、JAX-RS和Swagger的教程。然而，它们中的大多数似乎都使用了OpenAPI 2规范。我只找到一个使用Spring、JAX-RS和OpenAPI 3.0的教程(该教程使用Apache CXF)。是否有其他Spring Boot + JAX-RS实现可以与OpenAPI 3.0一起使用？例如，使用Jersey的所有教程似乎仅输出OpenAPI 2.0。Springdoc-
浏览 13提问于2019-08-20得票数 2
我正在尝试创建springdoc swagger文档，并且我希望以更好的客户端可读性的方式来表示具有数据类型Map<String, Object>的请求体。但是，当我声明@io.swagger.v3.oas.annotations.parameters.RequestBody(content = @Content(schema = @Schema(implementation= "/data/type", produces = APPLICATION_J
浏览 36提问于2020-11-25得票数 3
回答已采纳
这是我在Swagger在线上看到的我的OpenAPI 3.0定义的简化版本。我试图让这两个错误代码401和403响应，它们共享相同的模式，显示不同的示例--这似乎不起作用，而且我仍然将引用的类型视为示例。info: title: A service /doSomething:
浏览 1提问于2018-01-31得票数 4
回答已采纳
}
Open Liberty中的MicroProfile OpenAPI将自动生成以下OpenAPI (Swagger)文件：info:问题是嵌入式Swagger UI将date示例显示为空JS对象：我不确定这是不是Swagger UI端的bug，因为如果我没有在OpenAPI文件中提供任
浏览 2提问于2018-11-27得票数 3
问题
对象作为参数。YAMLinfo: title: Trackmeeasy API /getLabelUrl.action:- in: query c
浏览 0提问于2018-07-30得票数 2
回答已采纳
我有一个GET路由，我想在其中将url中的对象参数编码为查询字符串。在编写swagger文档时，我基本上得到了不允许我在query类型参数中使用schema/object类型的错误： /mypath/: parametersname: paging description: Holds various paging attributes
浏览 4提问于2016-07-04得票数 13
回答已采纳
我想返回一个200，它的模式根据参数是否被传递而有所不同，例如：GET /endpoint?selector=blah -> {200, schema_2}有没有办法做到这一点？
浏览 0提问于2016-04-12得票数 46
回答已采纳
有什么方法可以将Schema隐藏在Responses和Request body部件中吗？我们只需要向Example Value展示。我们使用OpenAPI 3。></dependency>
我们可以通过在listed schema文件中使用springdoc.swagger-ui.defaultMo
浏览 9提问于2022-06-07得票数 4
回答已采纳
云服务器
ICP备案
云直播
实时音视频
即时通信 IM
腾讯云开发者
