400-158-0245

概述

网页与手机端开发

系统架构

网页端开发

手机端开发

常见问题

API接口文档

说明

用户接口

文件核心操作接口

文件管理接口

其它文件操作接口

审批接口

讨论接口

快捷方式/发布接口

消息/提醒接口

多媒体接口

 

文件管理接口

1、列出当前管理员可管理的文件夹列表

有文件夹管理权限的普通管理员或超级管理员可调用本接口

URI: /app/file/list-manage-dir

POST参数:

token: token参数

返回的json.data是一个列表,列出该管理员可管理的每个文件夹(及该文件夹的子文件夹列表)

2、列出文件或文件夹上设置的所有权限

有文件夹管理权限的普通管理员或超级管理员可调用本接口

URI: /app/file/list-file-auth

POST参数:

token: token参数

fileId: 文件或文件夹的ID

返回的json.data是一个列表,列出了该文件/文件夹的所有权限设置,如果json.data[index].fileId与POST提交的fileId不一致,则该权限是是从json.data[index].fileId继承而来

3、列出在用户、部门、角色、创建者上设置的所有权限

有文件夹管理权限的普通管理员或超级管理员可调用本接口

URI: /app/file/list-user-auth

POST参数:

token: token参数

userId: 用户、部门、角色或创建者的ID(提示:创建者ID是一个特殊值:2039878274)

返回的json.data是一个列表,列出了该userId拥有的所有权限设置,如果json.data[index].userId与POST提交的userId不一致,则该权限是从json.data[index].userId继承而来

4、添加文件/文件夹权限

有文件夹管理权限的普通管理员或超级管理员可调用本接口

注意:每个fileId-userId组合只能有一个权限设置,所以如果fileId-userId组合已经添加过权限,再调用本接口,将会用新的权限覆盖

URI: /app/file/add-file-auth

POST参数:

token: token参数

fileId: 文件或文件夹的ID

userId: 用户、部门、角色或创建者的ID(提示:创建者ID是一个特殊值:2039878274)

auth: 权限类型

优米云盘的权限类型用字母表示:

可见:V
上传:U
新建:N
预览:P
打印:T
修改:M
下载:D
外链:E
删除:R
所有权限:A
完全禁止:B

注意权限类型有联动关系,比如预览权限必须要同时有可见权限,即如果只添加预览权限,则auth参数必须写作:VP,关于权限联动的详细情况,可在云盘客户端添加权限界面实际操作即可知晓。

5、删除文件/文件夹上的权限

有文件夹管理权限的普通管理员或超级管理员可调用本接口

URI: /app/file/remove-file-auth

POST参数:

token: token参数

authId: 权限ID,可通过/app/file/list-file-auth或/app/file/list-user-auth获取

6、查看文件夹策略

有文件夹管理权限的普通管理员或超级管理员可调用本接口

文件夹策略可以设置文件夹允许大小、允许文件类型

URI: /app/file/view-folder-policy

POST参数:

token: token参数

fileId: 文件夹ID

返回的json.data如果有值,则json.data.size是限制文件夹大小,单位MB,json.data.fileExtend表示该文件夹允许的扩展名,多个扩展名用空格隔开

7、设置文件夹策略

有文件夹管理权限的普通管理员或超级管理员可调用本接口

URI: /app/file/set-folder-policy

POST参数:

token: token参数

fileId: 文件夹ID

size: 限制文件夹大小,单位MB

fileExtend: 限制文件扩展名,多个扩展名用空格隔开,如:”docx pptx xlsx doc ppt xls”

注意:size与fileExtend可同时填写一个或两个,如果两个都是空值,则表示该文件夹策略为不限制

8、文件置顶或解除置顶

有文件夹管理权限的普通管理员或超级管理员可调用本接口

URI: /app/file/top-order-file

POST参数:

token: token参数

fileId: 文件或文件夹的ID

type: type=1表示置顶,type=2表示解除置顶,如果文件已经置顶,同时因为有其它的文件也置顶,所以他未排在第一,再次调用置顶接口,文件将重新排第一

9、获取单文件的日志

有文件夹管理权限的普通管理员或超级管理员可调用本接口

URI:  /app/file/get-one-file-log

POST参数:

token: token参数

fileId: 文件或文件夹的ID

page: 当前页码(每次只展示30条日志,0表示第一页)