蓝眼云盘编程接口

/api/alien/fetch/upload/token

功能:一个蓝眼云盘受信任的用户请求一个UploadToken,用于给另一个用户向蓝眼云盘上传文件。

一般的使用场景是应用服务器蓝眼云盘请求UploadToken,然后将此UploadToken交由浏览器去向蓝眼云盘上传文件。

参数 类型 描述
email string 【必填】邮箱,用于确定请求者身份
password string 【必填】密码,用于确定请求者身份
filename string 【必填】即将上传的文件名,不能包含以下特殊符号:< > | * ? / \
expire int 【选填】UploadToken过期时间,单位:s。默认 86400s 即24h
privacy bool 【必填】文件的共有性。true表示文件私有,下载时必须要DownloadToken. false表示文件公有,任何人可以通过下载链接直接下载
size int 【必填】文件的大小。单位:byte
dir string 【必填】文件存放的路径。不能为空,必须以/开头,不能出现连续的//,不能包含以下特殊符号:< > | * ? \。举例:/app/blog/20180101121212001

/api/alien/upload

功能:浏览器拿着UploadToken通过FormData向蓝眼云盘上传文件。

一般的使用场景是应用服务器蓝眼云盘请求UploadToken,然后将此UploadToken交由浏览器去向蓝眼云盘上传文件。由于在请求UploadToken的时候已经传入了文件元信息,因此这里的文件信息必须要和/api/alien/fetch/upload/token传入的参数信息一致。

参数 类型 描述
uploadTokenUuid string 【必填】uploadToken标识,/api/alien/fetch/upload/token请求返回对象中的uuid
file file 【必填】文件,在浏览器中是通过<input type="file" name="file"/>来选择的

/api/alien/confirm

功能:应用服务器向蓝眼云盘确认某个文件是否确实已经上传好了。

参数 类型 描述
email string 【必填】邮箱,用于确定请求者身份
password string 【必填】密码,用于确定请求者身份
matterUuid string 【必填】浏览器上传完毕后,蓝眼云盘返回给浏览器的uuid

/api/alien/fetch/download/token

功能:一个蓝眼云盘受信任的用户请求一个DownloadToken,用于给另一个用户下载蓝眼云盘上的私有文件。

一般的使用场景是应用服务器蓝眼云盘请求DownloadToken,然后将此DownloadToken交由浏览器去向蓝眼云盘下载文件。

参数 类型 描述
email string 【必填】邮箱,用于确定请求者身份
password string 【必填】密码,用于确定请求者身份
matterUuid string 【必填】文件uuid,要想下载的文件uuid
expire int 【选填】UploadToken过期时间,单位:s。默认 86400s 即24h

/api/alien/fetch/download/token

功能:一个蓝眼云盘受信任的用户请求一个DownloadToken,用于给另一个用户下载蓝眼云盘上的私有文件。

一般的使用场景是应用服务器蓝眼云盘请求DownloadToken,然后将此DownloadToken交由浏览器去向蓝眼云盘下载文件。

参数 类型 描述
email string 【必填】邮箱,用于确定请求者身份
password string 【必填】密码,用于确定请求者身份
matterUuid string 【必填】文件uuid,要想下载的文件uuid
expire int 【选填】UploadToken过期时间,单位:s。默认 86400s 即24h

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

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

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

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

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

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

额外参数
参数 类型 描述 取值范围
imageProcess string 指定图片处理的方式,对于图片缩放固定为resize 固定为resize
imageResizeM string 指定图片缩放的策略,有三种策略,fit 表示固定一边,另一边按比例缩放;fill表示先将图片延伸出指定W与H的矩形框外,然后进行居中裁剪;fixed表示直接按照指定的W和H缩放图片,这种方式可能导致图片变形 [fit,fill,fixed] 不填默认fit
imageResizeW int 指定的宽度,对于fit可以不指定 1 ~ 4096
imageResizeH int 指定的高度,对于fit可以不指定 1 ~ 4096
示例

原图:


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

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

http://tank.eyeblue.cn/api/alien/download/3f4b3090-e688-4d63-7705-93a120690505/horse.jpg?imageProcess=resize&imageResizeM=fit&imageResizeW=200

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

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

http://tank.eyeblue.cn/api/alien/download/3f4b3090-e688-4d63-7705-93a120690505/horse.jpg?imageProcess=resize&imageResizeM=fit&imageResizeH=200

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

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

    http://tank.eyeblue.cn/api/alien/download/3f4b3090-e688-4d63-7705-93a120690505/horse.jpg?imageProcess=resize&imageResizeM=fill&imageResizeW=200&imageResizeH=200

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

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

http://tank.eyeblue.cn/api/alien/download/3f4b3090-e688-4d63-7705-93a120690505/horse.jpg?imageProcess=resize&imageResizeM=fixed&imageResizeW=200&imageResizeH=200

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,378评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,356评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,702评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,259评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,263评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,036评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,349评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,979评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,469评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,938评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,059评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,703评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,257评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,262评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,485评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,501评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,792评论 2 345