钉钉开发文档

通讯录权限范围

更新时间: 2019-4-8

调用通讯录接口能获取哪些部门和员工的数据是受通讯录权限范围控制的。对于企业内部开发者(企业应用开发),通讯录权限范围是通过应用的“授权范围”来设置。

获取通讯录权限范围

在开发者获取到可以访问企业通讯录接口的token后,正式获取通讯录数据前,应该先调用本接口,获取当前token的权限范围,再依次遍历本接口返回的部门id列表,调用通讯录相应接口。


对于企业开通的第三方ISV应用,企业管理员可以在如下位置进行授权范围的调整,钉钉客户端->工作TAB->管理->选择应用->设置->授权使用范围。

接口说明:
请求方式:GET
请求地址https://oapi.dingtalk.com/auth/scopes?access_token=ACCESS_TOKEN

SDK请求示例(JAVA)

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/auth/scopes");
OapiAuthScopesRequest request = new OapiAuthScopesRequest();
request.setHttpMethod("GET");
OapiAuthScopesResponse response = client.execute(request, accessToken);

返回结果

{
    "errcode": 0,
    "errmsg": "created",
    "auth_user_field":["name","email"],
    "condition_field":["contact_call"],
    "auth_org_scopes":{
    "authed_dept":[1,2,3],
    "authed_user":["user1","user"],
    }
}
参数 说明 详细
errcode 返回码
errmsg 对返回码的文本描述内容
auth_user_field 可以得到的企业用户字段 name:员工名称,email员工邮箱 具体参见user/get接口字段描述
authed_dept 企业授权的部门id列表 返回值为授权部门id的并集。 (设置“全部员工”时,返回授权的部门id为根部门ID,员工userid列表为空)
authed_user 企业授权的员工userid列表 返回值为授权人员id的并集。(设置“仅为管理员可见”时,返回所有的管理员id。授权的部门id列表为空)
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!