图片处理

/api/alien/download/{uuid}/{filename}

/api/alien/preview/{uuid}/{filename}

功能:在浏览器中下载文件

这个两个接口既可以下载公有文件,又可以下载私有文件。同时对于图片文件还可以做裁剪缩放等操作。

区别是download接口会在http header中加上Content-Disposition,浏览器会自动当成下载处理。

区别是preview接口不会在http header中加上Content-Disposition,因此浏览器会直接以预览模式打开。

访问级别注册用户,管理员

请求参数

名称 类型 必填性 描述
uuid string 必填 文件的uuid,该参数放在url的路径中
filename string 必填 文件的名称,该参数放在url的路径中
downloadTokenUuid string 选填 download的uuid,如果是私有文件该参数必须,公有文件无需填写

返回: 二进制的文件

该接口同时还可以对图片进行缩放预处理

图片缩放支持的格式有:".jpg", ".jpeg", ".png", ".tif", ".tiff", ".bmp", ".gif"

额外参数

格式为 ir=mode_width_height

参数 类型 描述 取值范围
mode string 指定图片缩放的策略,有三种策略,fit 表示固定一边,另一边按比例缩放;fill表示先将图片延伸出指定W与H的矩形框外,然后进行居中裁剪;fixed表示直接按照指定的W和H缩放图片,这种方式可能导致图片变形 [fit,fill,fixed]
width int 指定的宽度,0表示自动适应 1 ~ 4096
height int 指定的高度,0表示自动适应 1 ~ 4096
示例

原图:

将宽度指定为200,高度等比例缩放

  1. 将宽度指定为200,高度等比例缩放

将宽度指定为200,高度等比例缩放

http://tanker.eyeblue.cn/api/alien/preview/3f4b3090-e688-4d63-7705-93a120690505/horse.jpg?ir=fit_200_0

  1. 将高度指定为200,宽度等比例缩放

将高度指定为200,宽度等比例缩放

http://tanker.eyeblue.cn/api/alien/preview/3f4b3090-e688-4d63-7705-93a120690505/horse.jpg?ir=fit_0_200

  1. 图片自动填充在200*200的大小中 (这种情况用得最多)

图片自动填充在200*200的大小中

http://tanker.eyeblue.cn/api/alien/preview/3f4b3090-e688-4d63-7705-93a120690505/horse.jpg?ir=fill_200_200

  1. 图片固定大小200*200 (一般会导致变形)

图片自动填充在200*200的大小中

http://tanker.eyeblue.cn/api/alien/preview/3f4b3090-e688-4d63-7705-93a120690505/horse.jpg?ir=fixed_200_200

上次更新: 2022/4/4 下午9:41:39