高级文件权限

更新: 2017-11-9

API域名

Host: yk3-api-ent.gokuai.com

注意: 库文件操作API使用的secret是 库授权 后获得的 org_client_secret


设置权限

POST /2/file/set_permission HTTP/1.1

请求参数

名称 必需 说明
org_client_id 库授权client_id
fullpath 文件完整路径
permissions 格式见下方说明
dateline 当前unix时间戳, 单位秒
sign 签名

permissions格式:

{
    group_ids: [
        部门ID(int),
        ...
    ],
    group_out_ids: [
        部门在外部系统唯一ID(string),
        ...
    ],
    member_ids: [
        成员ID(int),
        ...
    ],
    accounts: [
        成员登录帐号(string),
        ...
    ],
    out_ids: [
        成员在外部系统的唯一ID(string),
        ...
    ],
    permission: {
        role_id: 角色ID(int), //自定权限时用0,
        ls: 权限状态(int),
        ...
    }
}
key 说明
group_ids 设置部门时, 传部门ID
group_out_ids 设置部门时, 传部门在外部系统的唯一ID
member_ids 设置成员时, 传成员ID
accounts 设置成员时, 传成员登录帐号
out_ids 设置成员时, 传成员在外部系统的唯一ID
permission 具体需要设置的权限

其中group_idsgroup_out_ids传一个即可

member_idsaccountsout_ids传一个即可

权限状态 说明
1 拥有该权限
-1 拒绝该权限
0 没有该权限, 可不设置

返回结果

HTTP 200


设置权限继承

/2/file/set_permission_inherit HTTP/1.1

请求参数

名称 必需 说明
org_client_id 库授权client_id
fullpath 文件完整路径
inherit 是否开启权限继承, 1是, 0
keep 是否保留并合并上级权限, 1是, 0
dateline 当前unix时间戳, 单位秒
sign 签名

返回结果

HTTP 200


批量设置权限

POST /2/file/batch_set_permission HTTP/1.1

请求参数

名称 必需 说明
org_client_id 库授权client_id
fullpaths 文件完整路径, 多个使用竖号 | 分隔
type 批量设置方式, 0添加权限, 1设置权限, 将原有权限清空后设置
inherit 是否开启权限继承, 1是, 0
permissions 格式见下方说明
dateline 当前unix时间戳, 单位秒
sign 签名

permissions格式:

{
    group_ids: [
        部门ID(int),
        ...
    ],
    group_out_ids: [
        部门在外部系统唯一ID(string),
        ...
    ],
    member_ids: [
        成员ID(int),
        ...
    ],
    accounts: [
        成员登录帐号(string),
        ...
    ],
    out_ids: [
        成员在外部系统的唯一ID(string),
        ...
    ],
    permission: {
        role_id: 角色ID(int), //自定权限时用0,
        ls: 权限状态(int),
        ...
    }
}

返回结果

HTTP 200


删除权限

/2/file/del_permission HTTP/1.1

请求参数

名称 必需 说明
org_client_id 库授权client_id
fullpath 文件完整路径
ids 格式见下方说明
dateline 当前unix时间戳, 单位秒
sign 签名

ids:

{
    group_ids: [
        部门ID(int),
        ...
    ],
    group_out_ids: [
        部门在外部系统唯一ID(string),
        ...
    ],
    member_ids: [
        成员ID(int),
        ...
    ],
    accounts: [
        成员登录帐号(string),
        ...
    ],
    out_ids: [
        成员在外部系统的唯一ID(string),
        ...
    ]
}

返回结果

HTTP 200


获取成员权限

/2/file/get_member_permission HTTP/1.1

请求参数

名称 必需 说明
org_client_id 库授权client_id
fullpath 文件完整路径
member_id - 成员ID
out_id - 成员外部系统唯一ID
account - 成员外部系统登录帐号
dateline 当前unix时间戳, 单位秒
sign 签名

注: 参数中的member_id, out_idaccount必须传其中之一

返回结果

{
    ss: 权限的值(int),
    ...
}

获取部门权限

/2/file/get_group_permission HTTP/1.1

请求参数

名称 必需 说明
org_client_id 库授权client_id
fullpath 文件完整路径
group_id - 部门ID
group_out_id - 部门在外部系统的唯一ID
dateline 当前unix时间戳, 单位秒
sign 签名

注: 参数中的group_idgroup_out_id必须传其中之一

返回结果

{
    ss: 权限的值(int),
    ...
}

权限对照表

权限 说明
ls 显示
cd 进入目录
pv 预览文件
dl 下载/打开文件
w 写入/编辑文件
ul 添加新文件
mk 新建文件夹
ren 重命名
rm 删除
ln 外链分享
h 查看历史版本
hr 还原历史版本
rmk 查看评论 / @
rmka 添加评论 / @
t 添加标签
trm 删除标签
p 查看共享参与人
ps 管理共享参与人
ss 显示当前项
sren 重命名当前项
srm 删除当前项
mls 修改库设置
b 查看回收站文件
br 还原回收站文件
be 删除/清空回收站文件
mln 管理库文件(夹)外链