如何在 Swagger UI 中发送 multipart/form-data 中的 JSON 数组？

Question

我正在尝试通过 multipart/form-data 发送一组对象：

post:
      summary: Creates a user
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties: # Request parts
                id:
                  type: string
                  format: uuid
                address:      # <---------
                  type: array
                  items:
                    type: object
                    properties:
                      street:
                        type: string
                      city:
                        type: string
                profileImage:
                  type: string
                  format: base64

但是 Swagger UI 错误地发送了 address 数组 - 作为 {},{} 而不是 [{},{}]，也就是说，没有封闭的方括号：

我什至尝试将其单独编码为 JSON。

请问我遗漏了什么？

Answer 1

我后来通过添加例子让它工作

post:
      summary: Creates a user
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties: # Request parts
                id:
                  type: string
                  format: uuid
                address:
                  type: array
                  items:
                    type: object
                    properties:
                      street:
                        type: string
                      city:
                        type: string
                    example:
                      - street: Jones Street, Manhattan
                        city: New York
                      - street: Hollywood Boulevard
                        city: Los Angeles
                profileImage:
                  type: string
                  format: base64

我的观察只是发送或修改您在示例中已有的内容，添加新的不会正确格式化。也就是说，如果您在一个数组中有两个项目，请使用这两个项目，不要添加额外的项目

如何在 Swagger UI 中发送 multipart/form-data 中的 JSON 数组？

How to send a JSON array in multipart/form-data in Swagger UI?

multipartform-data

swagger-ui

openapi