我使用SpringBoot和springdoc-openapi-ui。我有带方法的控制器，它包含了url参数形式的数组： @Parameters(value = {
@Parameter(in = ParameterIn.QUERY, name为什么示例数组没有显示在item中？
浏览 75提问于2020-10-30得票数 0
我试图使用Swagger来定义接受实际文件的API和描述文件内容的模式对象。这是“摇摆YAML”的一个片段。但是，它不会在Swagger中验证。in: formData required: trueSwagger或者这不是Swagger的一个受支持的特性？
浏览 6提问于2015-09-22得票数 7
2回答
我使用以下spring-boot依赖项为我的Spring-boot应用程序生成一个swagger文件： <groupId>io.springfox</groupId><artifactId>springfox-swagger2</artifactId>
浏览 3提问于2020-02-11得票数 1
我试图将以下JSON映射到OpenAPI 2.0 (Swagger2.0) YAML定义，并且我不知道如何将混合数组类型设置到我的模式中： "obj1": [ 1}schema: type: array type: string
但这不允许数组中的整数是否有方法定义混合类
浏览 2提问于2016-08-01得票数 14
回答已采纳
我有一个返回类型，它是一个包含两个元素的数组。第一个元素是一个整数，第二个元素是一个带有sql_ident和name键的字典数组。sql_ident值是一个整数，name值是一个字符串。
浏览 2提问于2017-01-28得票数 1
3回答
我使用Swagger和Scala来记录我的REST。我希望启用对POST、PUT和DELETE的大容量操作，并希望同一路由接受单个对象或对象集合作为正文内容。有没有办法告诉Swagger，param是A类型的值列表，还是A类型的单个值？
像瓦拉格这样的人休息。
浏览 1提问于2015-07-31得票数 15
回答已采纳
2回答
我正在为其编写Swagger 2.0规范的API基本上是任何JSON值的存储。不幸的是，Swagger 2.0似乎对输入和输出的模式非常严格，并且不允许JSON Schema所允许的整个模式集。例如，Swagger编辑器不允许混合值(例如，可以是布尔值或整数的属性)或松散定义的数组(必须严格定义项的类型)和对象。-只是Swagger编辑器的错误还是Swagger 2.0规范的强大限制？-有没有更好的方法(最佳实践)来指定我需要什么？-我可以期待
浏览 2提问于2015-09-29得票数 9
回答已采纳
在为springdoc OpenAPI v3 api-docs生成输出时，任何细微的更改都会导致在生成的v3 api文档中产生完全不同的顺序。
浏览 166提问于2020-07-13得票数 0
它看起来不错，而且我喜欢对OpenAPI (Swagger)的内置支持。我设法将OpenAPI文档放在一个本地Swagger-UI中，并且我能够创建一些文档，这些文档在Swagger-UI中如期显示。不幸的是，OpenAPI文档生成在这个设置中不能正常工作-它被跳过。似乎getter约定是必需的。 有没有支持lombok fluent访问器的Micronaut-Swagger扩展？https:&#x
浏览 39提问于2019-04-24得票数 1
Swagger2.0中的全局definitions部分和components部分有什么不同？
我遇到了一个Swagger定义的YAML文件，它被标记为swagger: '2.0'。我不太确定definitions是否适合Swagger2.0，components和schemas是否在美洲国家组织3.0中。是真地吗？definitions和components可以同时用于swagger: '2.0'类型相同的YAML文件中吗?还是应该坚持defini
浏览 0提问于2019-08-20得票数 11
当前，我的swagger输出是一个身体参数，如下所示 "name": "body", "description": "", "type": "file"我阅读了这样的文档，即type属性可以是一个类型<em
浏览 2提问于2017-08-04得票数 1
回答已采纳
2回答
使用OpenApi的实际优势是什么？
我是openApi技术的新手，我只是想知道在openApi中有哪些特性比在swagger中有更多的特性。网上文件帮不了我。有人能帮我吗。
浏览 2提问于2020-04-03得票数 9
回答已采纳
1回答
我正在将我的应用编程接口从Swagger2.0迁移到OpenAPI 3.0。在DTO中，我有一个指定为字节数组的字段。: binary 使用上面的定义，swagger代码生成器生成一个接受byte[]数组作为主体字段new Job().setBody(new byte[1])的对象。在将API定义转换为OpenAPI之后，该对象的定义保持不变，但是openapi代码生成器现在需要org.springframework.core.io.Resource而不是byte[]
浏览 62提问于2020-07-08得票数 10
回答已采纳
我看到这是最后一个插件id "org.springdoc.openapi-gradle- plugin“版本"1.3.3”，它与spring 2.6不兼容。
浏览 11提问于2022-03-15得票数 0
在swagger文件中，byte[]被建模为byte[]数组。当使用swagger codegen时，我们得到的是List<byte[]>而不是简单的byte[]"document": { "type": "string", }
浏览 4提问于2019-01-03得票数 4
1回答
我试图用swagger描述以下post参数：
"AnyOne“= ["971"，50.0，70.0，"832"，50.0，30.0，”134 a“，50.0,100.0]
浏览 4提问于2022-02-15得票数 -1
configUrl=/v3/api-docs/swagger-config#/访问Swagger UI时，在UI中得到一条消息："Failed to load API definition"，并在控制台中得到一个异常scheme = "bearer"public class OpenApiConfig {
public OpenAPIconfigUrl=&
浏览 312提问于2020-10-22得票数 2
x_param = openapi.Parameter('x', in_=openapi.IN_FORM, description='srring',type=openapi.TYPE_STRING)
ty
浏览 12提问于2018-06-19得票数 25
在https://editor.swagger.io中，将$ref: '#/definitions/EnumExample1'替换为type: array。我看不到错误。但是我不确定如何在swagger-gen代码中修复这个问题。 如果需要更多的信息来理解这个问题，请在评论中发表！Swagger代码段 parameters: name: parameterNameX
description: parameterNameX&
浏览 122提问于2020-07-29得票数 0
回答已采纳
云服务器
ICP备案
云直播
即时通信 IM
实时音视频
腾讯云开发者
