dingtalk.oapi.role.removerolesforemps (批量删除员工角的色信息)

企业在做企业员工管理的时候,需要对部分员工进行角色分类,该接口可以批量删除员工的角色信息。 角色在钉钉的组织结构里面就是标签的意思,你可以批量为一批用户添加一批角色信息(dingtalk.corp.role.addrolesforemps),那么调用该接口就可以批量删除已经存在的角色和员工对应关系,角色和员工是多对多的关系。参考代码如下: req.setRolelidList("1,2,3,4,5"); // 已经存在的角色id列表 req.setUseridList("a,b,c,d,e"); // 用户的id列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
roleIds Number [] 必须 1,2
  • 最大列表长度:20
  • 角色标签id
    userIds String [] 必须 a,b
  • 最大列表长度:100
  • 用户userId

    响应参数

    名称 类型 示例值 描述
    errcode Number 0 errcode
    errmsg String ok errmsg

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/role/removerolesforemps");
    OapiRoleRemoverolesforempsRequest req = new OapiRoleRemoverolesforempsRequest();
    req.setRoleIds("1,2");
    req.setUserIds("a,b");
    OapiRoleRemoverolesforempsResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "errcode":0,
        "errmsg":"ok"
    }

    异常示例

    • JSON示例
    {
    	"errcode":88,
    	"errmsg":"ding talk error"
    }

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部