资源工坊

批量导入公告权限角色 ​

导入权限管理人员信息

请求说明 ​

请求地址配置域名+/o/woa/api/v1/announce/developer/role/batch_add
请求方法POST
签名方式wps-4
支持应用类型企业自建应用、第三方企业应用
权限要求批量导入公告权限角色(kso.announce_role.readwrite)

请求头 ​

Header名称是否必填说明
Content-Type是目前固定为："application/json"
Wps-Docs-Date是取当前时间, 示例: Wed, 23 Jan 2013 06:43:08 GMT
Wps-Docs-Authorization是计算方法参考签名说明
Authorization是access_token(企业授权获取的token)

请求地址示例 ​

http
[POST] 配置域名+/o/woa/api/v2/workflow/developer/developer/role/batch_add?operator=

查询参数（Query） ​

名称类型是否必填说明
operatorint是操作人（wpsUid）

请求体（Body） ​

参数类型是否必填说明
roles[]object是角色列表，（限制一次最多传200个）
 ∟ role_namestring是角色名称
 ∟ role_tabs[]string是权限范围列表
 ∟ users[]string是用户id列表
 ∟ send_rangeobject是发送范围对象
    ∟ corp_idstring否发送范围全公司时，公司id
    ∟ department_ids[]string否发送范围是部门时，部门id列表
    ∟ user_ids[]string否发送范围是用户时，用户id列表（wps_uid）

权限范围列表枚举 ​

text
"announcement_management" : 公告管理tab
"group_management" ： 分组管理tab
"security_level_management" ： 密级设置tab
"permission_management" ： 权限管理yab

请求体示例 ​

json
{
  "roles": [
    {
      "role_name": "省行管理员",
      "users": ["48923729372", "83950384392"],
      "role_tabs": [
        "announce_manage",
        "group_manage",
        "security_level_management"
      ],
      "send_range": {
        "corp_id": "4210008",
        "department_ids": ["478236432842", "4293847292"],
        "user_ids": ["289371931", "178319313113"]
      }
    },
    {
      "role_name": "总行管理员",
      "users": ["48923729372", "83950384392"],
      "role_tabs": ["announce_manage", "group_manage"],
      "send_range": {
        "corp_id": "4210008",
        "department_ids": ["478236432842", "4293847292"],
        "user_ids": ["289371931", "178319313113"]
      }
    }
  ]
}

响应体 ​

名称类型说明
resultstringok：成功，其他-失败
msgstring错误信息

响应体示例 ​

json
{
  "result": "ok"
}