dingtalk.oapi.role.visible.get (查询企业下某个角色的可见角色列表)

在钉钉企业通讯录内,支持设置角色之间的可见性。这个接口的目的是用来获取某个角色设置的可见角色列表。返回的是roleIdList。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
role_id Number 必须 123 角色ID
size Number 可选 100
  • 默认值:100
  • 批量大小
    offset Number 可选 0
  • 默认值:0
  • 偏移量

    响应参数

    名称 类型 示例值 描述
    errcode Number 0 错误码
    errmsg String OK 错误信息
    result PageVo result 结果
    • └ next_cursor
    • String
    • 1
    • 下次请求的游标
    • └ has_more
    • Boolean
    • false
    • 是否还有数据
    • └ list
    • Number []
    • 123,456
    • roleIdList

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/role/visible/get");
    OapiRoleVisibleGetRequest req = new OapiRoleVisibleGetRequest();
    req.setRoleId(123L);
    req.setSize(100L);
    req.setOffset(0L);
    OapiRoleVisibleGetResponse rsp = client.execute(req, access_token);
    System.out.println(rsp.getBody());

    响应示例

    • JSON示例
    {
        "errcode":0,
        "errmsg":"OK",
        "result":{
            "next_cursor":"1",
            "has_more":false,
            "list":{
                "number":[
                    123,
                    456
                ]
            }
        }
    }

    异常示例

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

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部