Question

我正在使用OpenApi 3.0.2规范使用swagger-ui。
我设置了具有多部分/表单数据内容的requestBody。
当我执行swagger-ui的请求时，一切正常，但是...
如果添加数组类型的参数，则它将在curl调用中通过以下方式进行转换：
-F "tags=my,tag"
我需要将数组分解

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

我看了一下文档，发现了一些样式和爆炸属性，但它们仅适用于参数属性，不适用于requestBody（？）。

在我的路线文件中：

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

和media-image-base.yaml

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

Answer 1

好，我找到了解决方法。
我只需要重命名tags中的tags[]属性，现在就可以使用了。

swagger-ui-打开api 3，多部分/表单数据数组问题

1 个答案: