企业微信_通讯录管理,获取部门列表部门成员及详情

企业微信H5_通讯录管理,获取部门列表部门成员及详情
在这里插入图片描述

一、POSTMAN调试

官网文档
获取通讯录信息前提,获取access_token

1. 获取access_token

在这里插入图片描述
请求方式: GET(HTTPS)
请求地址:

https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

在这里插入图片描述

{
	"errcode": 0,
	"errmsg": "ok",
	"access_token": "mvppke7aH_VqezkZeXob7szzJNKLPAc5Mr-91bYZUyJ-KIqGXt2tY7d9o1f7ds5yCdQLDJfrfiucAk_38MZ9o7Ly43pG2QzqvDiC4skFMl7S8Kwido8tuP-RHl0spk322aDU8-F8hluEhi5y-WdcrZjaoS3R9aC08KJqLJzFvDwRyA8Ex14lVMXCBg1hUdZnknRdIXeh-byiJdz5RL69Mw",
	"expires_in": 7200
}
2. 获取部门列表

在这里插入图片描述
请求方式:GET(HTTPS)
请求地址:

https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=ACCESS_TOKEN&id=ID

在这里插入图片描述

{
	"errcode": 0,
	"errmsg": "ok",
	"department": [
		{
			"id": 1,
			"name": "泽昕科技股份有限公司",
			"parentid": 0,
			"order": 100000000,
			"department_leader": []
		},
		{
			"id": 2,
			"name": "开发一部",
			"parentid": 1,
			"order": 100000000,
			"department_leader": []
		},
		{
			"id": 3,
			"name": "部门1",
			"parentid": 2,
			"order": 100000000,
			"department_leader": []
		},
		{
			"id": 4,
			"name": "部门2",
			"parentid": 2,
			"order": 99999000,
			"department_leader": []
		}
	]
}
3. 获取部门成员

在这里插入图片描述
请求方式:GET(HTTPS)
请求地址:

https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID&fetch_child=FETCH_CHILD

在这里插入图片描述

{
	"errcode": 0,
	"errmsg": "ok",
	"userlist": [
		{
			"userid": "ZeXin",
			"name": "泽昕",
			"department": [
				1
			]
		},
		{
			"userid": "lifei",
			"name": "李飞",
			"department": [
				1,
				2
			]
		}
	]
}
4. 获取部门成员详情

在这里插入图片描述

5. 获取成员详情

在这里插入图片描述
请求方式:GET(HTTPS)
请求地址:

https://qyapi.weixin.qq.com/cgi-bin/user/list?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID&fetch_child=FETCH_CHILD

在这里插入图片描述

{
	"errcode": 0,
	"errmsg": "ok",
	"userlist": [
		{
			"userid": "ZeXin",
			"name": "泽昕",
			"department": [
				1
			],
			"position": "项目经理",
			"mobile": "13396492261",
			"gender": "1",
			"email": "gblfy002@163.com",
			"avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM4de1RtaqgB6CTZ1mOMTFK9JH8brF8FZlqJP20rcuyTFA/0",
			"status": 1,
			"enable": 1,
			"isleader": 0,
			"extattr": {
				"attrs": []
			},
			"hide_mobile": 0,
			"telephone": "88888888",
			"order": [
				0
			],
			"external_profile": {
				"external_attr": [],
				"external_corp_name": ""
			},
			"main_department": 1,
			"qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vce2609ebe698837fd",
			"alias": "泽昕",
			"is_leader_in_dept": [
				0
			],
			"address": "北京市通州区华馨园6楼号",
			"thumb_avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM4de1RtaqgB6CTZ1mOMTFK9JH8brF8FZlqJP20rcuyTFA/132",
			"direct_leader": [],
			"biz_mail": "zexin@zxkjgfyxgs10.wecom.work"
		},
		{
			"userid": "lifei",
			"name": "李飞",
			"department": [
				1,
				2
			],
			"position": "项目经理2",
			"mobile": "17624217407",
			"gender": "1",
			"email": "lifei@xxxx.com",
			"avatar": "https://wework.qpic.cn/bizmail/H55fHUJ7DCe3HYqE2nciblrHjegUFriaCWEqRPxD6Xmzm71UV9W3y7zA/0",
			"status": 1,
			"enable": 1,
			"isleader": 0,
			"extattr": {
				"attrs": []
			},
			"hide_mobile": 0,
			"telephone": "88888888",
			"order": [
				0,
				0
			],
			"external_profile": {
				"external_attr": [],
				"external_corp_name": ""
			},
			"main_department": 1,
			"qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vcc1f347b43d90cc2f",
			"alias": "李飞",
			"is_leader_in_dept": [
				0,
				0
			],
			"address": "北京市大兴区新华保险亦庄后援中心137号",
			"thumb_avatar": "https://wework.qpic.cn/bizmail/H55fHUJ7DCe3HYqE2nciblrHjegUFriaCWEqRPxD6Xmzm71UV9W3y7zA/100",
			"direct_leader": [],
			"biz_mail": "lifei@zxkjgfyxgs10.wecom.work"
		}
	]
}
二、实战演练
2.1. 获取部门列表

在这里插入图片描述

{
    "code": 0,
    "msg": null,
    "data": {
        "errcode": 0,
        "errmsg": "ok",
        "department": [
            {
                "id": 1,
                "name": "泽昕科技股份有限公司",
                "parentid": 0,
                "order": 100000000,
                "department_leader": []
            },
            {
                "id": 2,
                "name": "开发一部",
                "parentid": 1,
                "order": 100000000,
                "department_leader": []
            },
            {
                "id": 3,
                "name": "部门1",
                "parentid": 2,
                "order": 100000000,
                "department_leader": []
            },
            {
                "id": 4,
                "name": "部门2",
                "parentid": 2,
                "order": 99999000,
                "department_leader": []
            }
        ]
    }
}
2.2. 获取部门成员

演示:部门id等于1
在这里插入图片描述

{
    "code": 0,
    "msg": null,
    "data": {
        "errcode": 0,
        "userlist": [
            {
                "userid": "ZeXin",
                "name": "泽昕",
                "department": [
                    1
                ]
            },
            {
                "userid": "lifei",
                "name": "李飞",
                "department": [
                    1,
                    2
                ]
            }
        ],
        "errmsg": "ok"
    }
}
2.3. 获取部门成员详情

在这里插入图片描述

{
    "code": 0,
    "msg": null,
    "data": {
        "errcode": 0,
        "userlist": [
            {
                "userid": "ZeXin",
                "name": "泽昕",
                "department": [
                    1
                ],
                "position": "项目经理",
                "mobile": "13xxxx1",
                "gender": "1",
                "email": "gblfy002@163.com",
                "avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM4de1RtaqgB6CTZ1mOMTFK9JH8brF8FZlqJP20rcuyTFA/0",
                "status": 1,
                "enable": 1,
                "isleader": 0,
                "extattr": {
                    "attrs": []
                },
                "hide_mobile": 0,
                "telephone": "88888888",
                "order": [
                    0
                ],
                "external_profile": {
                    "external_attr": [],
                    "external_corp_name": ""
                },
                "main_department": 1,
                "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vce2609ebe698837fd",
                "alias": "泽昕",
                "is_leader_in_dept": [
                    0
                ],
                "address": "北京市通州区华馨园6楼号",
                "thumb_avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM4de1RtaqgB6CTZ1mOMTFK9JH8brF8FZlqJP20rcuyTFA/132",
                "direct_leader": [],
                "biz_mail": "zexin@zxkjgfyxgs10.wecom.work"
            },
            {
                "userid": "lifei",
                "name": "李飞",
                "department": [
                    1,
                    2
                ],
                "position": "项目经理2",
                "mobile": "1762xxxxx",
                "gender": "1",
                "email": "lifei@xxxx.com",
                "avatar": "http://wework.qpic.cn/bizmail/H55fHUJ7DCe3HYqE2nciblrHjegUFriaCWEqRPxD6Xmzm71UV9W3y7zA/0",
                "status": 1,
                "enable": 1,
                "isleader": 0,
                "extattr": {
                    "attrs": []
                },
                "hide_mobile": 0,
                "telephone": "88888888",
                "order": [
                    0,
                    0
                ],
                "external_profile": {
                    "external_attr": [],
                    "external_corp_name": ""
                },
                "main_department": 1,
                "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vcc1f347b43d90cc2f",
                "alias": "李飞",
                "is_leader_in_dept": [
                    0,
                    0
                ],
                "address": "北京市大兴区人才中心17号",
                "thumb_avatar": "http://wework.qpic.cn/bizmail/H55fHUJ7DCe3HYqE2nciblrHjegUFriaCWEqRPxD6Xmzm71UV9W3y7zA/100",
                "direct_leader": [],
                "biz_mail": "lifei@zxkjgfyxgs10.wecom.work"
            }
        ],
        "errmsg": "ok"
    }
}
2.4. 获取人员详情

演示:userid等于 “userid”: “ZeXin”
在这里插入图片描述

{
    "code": 0,
    "msg": null,
    "data": {
        "errcode": 0,
        "gender": "1",
        "is_leader_in_dept": [
            0
        ],
        "direct_leader": [],
        "userid": "ZeXin",
        "thumb_avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM4de1RtaqgB6CTZ1mOMTFK9JH8brF8FZlqJP20rcuyTFA/132",
        "enable": 1,
        "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vce2609ebe698837fd",
        "alias": "泽昕",
        "department": [
            1
        ],
        "biz_mail": "zexin@zxkjgfyxgs10.wecom.work",
        "email": "gblfy002@163.com",
        "order": [
            0
        ],
        "isleader": 0,
        "address": "北京市通州区华馨园6楼号",
        "mobile": "13396xxx1",
        "errmsg": "ok",
        "telephone": "88888888",
        "avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM4de1RtaqgB6CTZ1mOMTFK9JH8brF8FZlqJP20rcuyTFA/0",
        "hide_mobile": 0,
        "main_department": 1,
        "name": "泽昕",
        "extattr": {
            "attrs": []
        },
        "position": "项目经理",
        "external_profile": {
            "external_attr": [],
            "external_corp_name": ""
        },
        "status": 1
    }
}
三、代码讲解

其实很简单,就是前端发起请求后端api,后端请求企业微信,后端返回相应信息,前端进行展示。这里演示获取部门列表,其他的一样的

3.1. 获取部门列表(前端)

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

3.2. 获取部门列表(后端)

在这里插入图片描述

四、源码分享
4.1. 后端源码

后端:https://gitee.com/gblfy/qywx-inner-java
在这里插入图片描述

4.2. 前端源码

前端:https://gitee.com/gblfy/qywx-vuejs
在这里插入图片描述ywx-vuejs)

评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

gblfy

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值