我正在使用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
我错过了什么?
3条答案
按热度按时间laik7k3q1#
你的定义是正确的。
在Swagger Editor 3.5.7和Swagger UI 3.16.0中添加了对OpenAPI 3.0定义中
multipart/form-data
请求的文件上载支持。请确保您使用的版本支持文件上载。blmhpbnm2#
为了一个和我一样的人!!!
我必须将输入类型修改为请求的端点方法。
**注-**它可能无法满足所有类型的需求,但很少有人能从中受益
之前:
其中RequestModelName具有属性和getter/setter...
1.私有MultipartFile文件
1.私有字符串otherProp
通过这一点,我看不到文件选项在昂首阔步。
之后:
然后我可以看到文件选项在昂首阔步...
y53ybaqx3#
试用