Swagger-UI-Open API 3，多部分/表单数据数组问题 [英] swagger-ui - open api 3, multipart/form-data array problem

问题描述

我正在使用带有OpenApi 3.0.2规范的swagger-UI。
我设置了一个包含多部分/表单数据内容的questBody。
当我从swagger-ui执行请求时，一切正常，但是...
如果我添加一个数组类型的参数，它将在cURL调用中转换为这样的方式：
-F "tags=my,tag"
我需要分解数组

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

我查看了文档，找到了一些样式和分解属性，但它们只适用于参数属性，而不适用于questBody(？)。

在我的路径文件中：

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

媒体映像文件.yaml

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

和media-Image-base.yaml

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

推荐答案

好的，我找到了解决方案。
我只需重命名tags[]中的tags属性，现在它可以工作了。

这篇关于Swagger-UI-Open API 3，多部分/表单数据数组问题的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！