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

2019-05-24 20:24:07 浏览数 (2)

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

代码语言:javascript复制
/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"

效果如下:

0 人点赞