巴别鸟巴别鸟文档

设置分享参与人的权限角色

属性 值
HTTP 方法 POST
接口路径 /nd/api/file/set_participant_role
所属分类 分享 API

接口说明

POST 请求体参数

参数 类型 必填 说明
file_id string 是 文件 ID
babelshare_id string 是 取自 获取所有分享参与人 返回的 users[].babelshareId,保留字符串类型;不要使用 participantId、工号或邮箱替代。
role_id int 是 取自 获取分享权限类型 返回的 roles[].id,保留 JSON 整数类型;例如所选样例角色的 id 为 10,则传 10。不要传 permission、角色名称或数组下标。

表格可左右滚动查看

先用 file_id 查询分享参与人,取得目标记录的 babelshareId;再从分享角色列表选取要授予的 id,分别传入 babelshare_id 和 role_id。users[].roleId 表示该参与人当前的角色。

请求示例(参与人标识为示例值,文件 ID 需替换):

{
  "file_id": "<FILE_ID>",
  "babelshare_id": "1001",
  "role_id": 10
}

返回字段说明

{"code":0,"success":true}

调用说明

  • 调用前需完成 获取 token 或相应免登录认证,并在请求 Header 中携带 Authorization: Bearer <access_token>。
  • 参数和返回字段如因部署版本存在差异,应以实际私有云 API 文档和联调结果为准。
  • 所属分类:分享 API。
巴别鸟企业网盘文档内容会随产品版本、授权模块和部署配置更新;具体能力以实际部署与管理员配置为准。

本页 Markdown · AI 文档目录