Swagger文档添加file上传参数写法

时间:2023-01-31 16:57:26

想在swagger ui的yaml文档里面写一个文件上传的接口,找了半天不知道怎么写,终于搜到了,如下:

/tools/upload:
post:
tags:
- "tool"
summary: "文件上传、图片上传"
operationId: "upload"
consumes:
- multipart/form-data
parameters:
- name: file
in: formData
type: file
responses:
200:
description: 文件上传成功
schema:
properties:
url:
type: string
description: "文件上传后的地址"
500:
description: "服务器内部出错"
schema:
$ref: "#/definitions/ApiResponse"

效果如下:

Swagger文档添加file上传参数写法