企业内部开发 服务端API 通讯录管理 互联企业 获取互联企业部门成员详情
获取互联企业部门成员详情

请求方式: POST(HTTPS
请求地址: https://qyapi.weixin.qq.com/cgi-bin/linkedcorp/user/list?access_token=ACCESS_TOKEN

请求包体:

{
   "department_id": "LINKEDID/DEPARTMENTID",
   "fetch_child": true
}

参数说明:

参数必须说明
access_token调用接口凭证
department_id该字段用的是互联应用可见范围接口返回的department_ids参数,用的是 linkedid + ’/‘ + department_id 拼成的字符串
fetch_child是否递归获取子部门下面的成员:1-递归获取,0-只获取本部门,不传默认只获取本部门成员

权限说明:

仅自建应用可调用,应用须拥有指定部门的查看权限。

返回结果:

{
   "errcode": 0,
   "errmsg": "ok",
   "userlist": [{
        "userid": "zhangsan",
        "name": "张三",
        "department": [
            "LINKEDID/1" , "LINKEDID/2"
        ],
        "mobile": "+86 12345678901",
        "telephone": "10086",
        "email": "zhangsan@tencent.com",
        "position": "后台开发",
        "corpid": "xxxxxx",
        "extattr": {
                "attrs": [
                    {
                        "name": "自定义属性(文本)",
                        "value": "10086",
                        "type": 0,
                        "text": {
                            "value": "10086"
                        }
                    },
                    {
                        "name": "自定义属性(网页)",
                        "type": 1,
                        "web": {
                            "url": "https://work.weixin.qq.com/",
                            "title": "官网"
                        }
                    }
                ]
            }
        }
    ]
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
userlist成员列表,user包含的属性可在管理端配置
userid成员UserID。对应管理端的帐号,企业内必须唯一。不区分大小写,长度为1~64个字节
name成员真实名称
mobile手机号码
department成员所属部门id列表,这个字段只会返回传入的department_id所属的互联企业里的部门id
position职务信息
email邮箱
telephone座机
corpid所属企业的corpid
extattr扩展属性
上一篇
获取互联企业部门成员
下一篇
获取互联企业部门列表