高级文件权限

更新: 2025-10-10

• 设置权限
• 设置权限继承
• 批量设置权限
• 删除权限
• 获取成员权限
• 获取部门权限
• 权限对照表

API域名

Host: yk3.gokuai.com

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

设置权限

POST /m-open/2/file/set_permission HTTP/1.1

请求参数

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),
        ...
    }
}

其中group_ids和group_out_ids传一个即可

member_ids、accounts和out_ids传一个即可

返回结果

HTTP 200

设置权限继承

/2/file/set_permission_inherit HTTP/1.1

请求参数

返回结果

HTTP 200

批量设置权限

POST /m-open/2/file/batch_set_permission HTTP/1.1

请求参数

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

删除权限

POST /m-open/2/file/del_permission HTTP/1.1

请求参数

ids:

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

返回结果

HTTP 200

获取成员权限

POST /m-open/2/file/get_member_permission HTTP/1.1

请求参数

注: 参数中的member_id, out_id和account必须传其中之一

返回结果

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

获取部门权限

POST /m-open/2/file/get_group_permission HTTP/1.1

请求参数

注: 参数中的group_id和group_out_id必须传其中之一

返回结果

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

权限对照表