Skip to content

修改指定角色信息

修改指定角色信息

请求说明

请求地址配置域名+/o/woa/api/v1/announce/developer/role/:role_id/update
请求方法PUT
签名方式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计算方法参考签名说明
Authorizationaccess_token(企业授权获取的token)

请求地址示例

http
[PUT] 配置域名+/o/woa/api/v1/announce/developer/role/1/update?operator=123

查询参数(Query)

名称类型是否必填说明
operatorint操作人(wpsUid)

请求体(Body)

参数类型是否必填说明
role_namestring角色名称
role_tabs[]string权限范围列表
users[]string用户id列表
send_rangeobject发送范围对象
  ∟ corp_idstring发送范围全公司时,公司id
  ∟ department_ids[]string发送范围是部门时,部门id列表
  ∟ user_ids[]string发送范围是用户时,用户id列表(wps_uid)

请求体示例

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

响应体

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

响应体示例

json
{
  "result": "ok"
}