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

用户1141560

发布于 2019-05-24 20:24:07

13.7K0

发布于 2019-05-24 20:24:07

文章被收录于专栏：西安-晁州

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

效果如下：