在试用时,Swagger Editor OpenAPI 3上的文件上传不显示文件浏览器

u4dcyp6a  于 2022-12-13  发布在  其他
关注(0)|答案(3)|浏览(330)

我正在使用OpenAPI 3.0的Swagger编辑器。我需要记录一个上传图片的路径。当我尝试“尝试一下”时,我没有让文件浏览器在请求正文中选择要上传的图片,我得到的只是一个带有参数名称和类型的JSON字符串。

这是路由的YAML描述:

openapi: 3.0.0
...
paths:
  /media/upload/thumbnail:
    post:
      tags:
        - media
        - publications
      security:
        - bearerAuth: []
      summary: upload a kid's publication
      operationId: uploadPublication
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                upload:
                  type: string
                  format: binary
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: ObjectId of the uploaded file in db (original size)
                    example: 5a6048b3fad06019afe44f24
                  filename:
                    type: string
                    example: myPainting.png
                  thumbnail:
                    type: string
                    description: ObjectId of the uploaded file in db (thumbnai size)
                    example: 5a6048b3fad06019afe44f26
        '400':
          description: Authentication failed

我错过了什么?

laik7k3q

laik7k3q1#

你的定义是正确的。
在Swagger Editor 3.5.7和Swagger UI 3.16.0中添加了对OpenAPI 3.0定义中multipart/form-data请求的文件上载支持。请确保您使用的版本支持文件上载。

blmhpbnm

blmhpbnm2#

为了一个和我一样的人!!!
我必须将输入类型修改为请求的端点方法。

**注-**它可能无法满足所有类型的需求,但很少有人能从中受益
之前:

/myEndpoint( @RequestBody RequestModelName requestModelName )

其中RequestModelName具有属性和getter/setter...
1.私有MultipartFile文件
1.私有字符串otherProp
通过这一点,我看不到文件选项在昂首阔步。

之后:

/myEndpoint( @RequestParam MultipartFile file, @RequestParam String otherProp )

然后我可以看到文件选项在昂首阔步...

y53ybaqx

y53ybaqx3#

试用

content:
          image/png:
            schema:
              properties:
                file:
                  type: string
                  format: binary

相关问题