当前位置: 首页 > 知识库问答 >
问题:

大摇大摆的用户界面-打开api 3,多部分/表单数据数组问题

邹高峻
2023-03-14

我正在使用OpenApi 3.0.2规范使用swagger ui。
我设置了一个带有多部分/表单数据内容的requestBody
当我执行来自swagger ui的请求时,一切都正常,但是
如果我添加一个array类型的参数,它将以这种方式在curl调用中转换:
-F“tags=my,tag”
我需要分解数组

-F 'tags[]=my' \
-F 'tags[]=tag'

我看了看留档,找到了一些样式和爆炸属性,但它们只适用于参数属性,而不是请求体(?)。

在我的路线文件中:

post:
  tags:
  - media-image
  summary: Create a media image
  requestBody:
    description: A JSON object containing media image information
    required: true
    content:
      multipart/form-data:
        schema:
          allOf:
          - $ref: '../schemas/media-image-fillable.yaml'
          - required:
            - title
            - back_office_title
            - alt
            - file

media-image-fillable.yaml

type: object
allOf:
- $ref: './media-image-base.yaml'
- properties:
    file:
      type: string
      format: binary
    tags:
      type: array
      items:
        type: string

以及媒体形象库。亚马尔

type: object
properties:
  title:
    type: string
  back_office_title:
    type: string
  description:
    type: string
  alt:
    type: string

共有1个答案

白丁雨
2023-03-14

好的,我找到了解决办法
我只需在tags[]中重命名tags属性,现在就可以了。

 类似资料:
  • 我当时正在从事spring项目。首先,我将swagger添加到我的项目中,我的swagger用户界面也显示了所有控制器,但当我将JWT承载令牌添加到我的项目中时。不知何故,我无法进入大摇大摆的用户界面。它会一直在我的浏览器中显示以下窗口。我怎样才能解决这个问题有什么想法吗? 在pom中。xml 配置类昂首阔步其他配置类我没有到目前为止 使现代化 遵循代码后

  • thoses线有什么问题 “data”属性应该是$ref中给出的模式类型的数组,但这是结果 好的,似乎正确的方法是tu把$ref直接放在items键下,我的问题是使用保留键“status”,那么,我如何在对象模式中使用保留键呢? 在我的客户机模式中,我将属性status放了两次,但我没有看到它已经存在,所以当我更改属性名时,它起作用了,我在想“status”可能是一个保留的关键字。

  • 我成功地在Spring boot应用程序上应用了swagger ui,并能够使用http://localhost:8181/swagger-用户界面。html 过了一段时间,我继续写我的申请,现在它不见了。我没有拿走任何罐子。我添加了一个应用程序启动类,当我在Wildfly 10上部署时,该类用于在启动时加载一些东西。 即使我尝试用tomcat将其作为Spring boot应用程序运行,也无法运行

  • 我有一个java项目(tomcat webapp)和一些REST Api。我想为他们生成大摇大摆的文档。我从本教程(github)开始。我没有maven我们使用蚂蚁任务。我加入了swagger-annotations-1.5.0。jar和所有随swagger jaxrs jar 1.5.0版本附带的jar(如果有用的话,我可以包括一个完整的列表),我已经注释了一些方法,我有一个如下的配置类: }

  • 理想情况下,我们将有一个显示所有标记为public的控制器/方法的大摇大摆的页面,以及另一个显示所有endpoint的密码安全endpoint。这可能吗?

  • 有没有人用spring-data-rest配置了swagger。我知道swagger有DocumentationConfig类,它扫描所有spring-mvc请求映射。但是,如何将其用于spring-data-rest,因为没有定义显式的请求映射。非常感谢在这方面的任何帮助。此外,我还想知道,是否有其他支持Spring-Data-REST的文档框架。