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

想在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"

效果如下:

posted @ 2017-12-23 22:55  程序员小波与Bug  阅读(7617)  评论(0编辑  收藏  举报