LOGO OA教程 ERP教程 模切知识交流 PMS教程 CRM教程 开发文档 其他文档  
 
网站管理员

微信企业号开发之如何管理通讯录(1)
admin
2014年12月2日 0:47 本文热度 6625




文章简介：企业号通讯录具备完全开放的接口，你的应用可以调用这些接口管理部门、成员和标签。你的应用也可以使用部门、成员、标签发消息，或更改应用的可见范围。

企业号通讯录具备完全开放的接口，你的应用可以调用这些接口管理部门、成员和标签。


你的应用也可以使用部门、成员、标签发消息，或更改应用的可见范围。


注意，每个部门的直属员工上限为1000个；出于安全考虑，某些接口需要在管理端有明确的授权。


一、管理部门


1、创建部门



  • 请求说明

Https请求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN


请求包结构体为:

  1. { 
  2.    "name": "邮箱产品组", 
  3.    "parentid": "1" 
  4. } 


  • 参数说明


















参数 必须 说明
access_token 是 调用接口凭证
name 是 部门名称。长度限制为1~64个字符
parentid 是 父亲部门id。根部门id为1


  • 权限说明

管理员须拥有“操作通讯录”的接口权限，以及父部门的管理权限。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "created", 
    4.    "id": 2 
    5. } 














参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
id 创建的部门id。

2、更新部门



  • 请求说明

Https请求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/department/update?access_token=ACCESS_TOKEN


请求包结构体为（如果非必须的字段未指定，则不更新该字段之前的设置值）:

  1. { 
  2.    "id": 2, 
  3.    "name": "邮箱产品部" 
  4. } 


  • 参数说明


















参数 必须 说明
access_token 是 调用接口凭证
id 是 部门id。
name 否 更新的部门名称。长度限制为0~64个字符。修改部门名称时指定该参数


  • 权限说明

管理员须拥有“操作通讯录”的接口权限，以及该部门的管理权限。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "updated" 
    4. } 

3、删除部门



  • 请求说明

Https请求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/department/delete?access_token=ACCESS_TOKEN&id=1&id=2



  • 参数说明














参数 必须 说明
access_token 是 调用接口凭证
id 是 部门id。（注：不能删除根部门；不能删除含有子部门、成员的部门）


  • 权限说明

管理员须拥有“操作通讯录”的接口权限，以及该部门的管理权限。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "deleted" 
    4. } 

4、获取部门列表



  • 请求说明

Https请求方式: GET


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



  • 参数说明










参数 必须 说明
access_token 是 调用接口凭证


  • 权限说明

管理员须拥有’获取部门列表’的接口权限，以及对部门的查看权限。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "ok", 
    4.    "department": [ 
    5.        { 
    6.            "id": 1, 
    7.            "name": "广州研发中心", 
    8.            "parentid": 0 
    9.        }, 
    10.        { 
    11.            "id": 2 
    12.            "name": "邮箱产品部", 
    13.            "parentid": 1 
    14.        } 
    15.    ] 
    16. } 























参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
department 部门列表数据
id 部门id
name 部门名称
parentid 父亲部门id。根部门为1



二、管理成员


1、创建成员



  • 请求说明

Https请求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/user/create?access_token=ACCESS_TOKEN


请求包结构体为:

  1. { 
  2.    "userid": "zhangsan", 
  3.    "name": "张三", 
  4.    "department": [1, 2], 
  5.    "position": "产品经理", 
  6.    "mobile": "15913215421", 
  7.    "gender": 1, 
  8.    "tel": "62394", 
  9.    "email": "zhangsan@gzdev.com", 
  10.    "weixinid": "zhangsan4dev" 
  11. } 


  • 参数说明














































参数 必须 说明
access_token 是 调用接口凭证
userid 是 员工UserID。对应管理端的帐号，企业内必须唯一
name 是 成员名称。长度为1~64个字符
department 否 成员所属部门id列表。注意，每个部门的直属员工上限为1000个
position 否 职位信息。长度为0~64个字符
mobile 否 手机号码。企业内必须唯一，mobile/weixinid/email三者不能同时为空
gender 否 性别。gender=0表示男，=1表示女。默认gender=0
tel 否 办公电话。长度为0~64个字符
email 否 邮箱。长度为0~64个字符。企业内必须唯一
weixinid 否 微信号。企业内必须唯一


  • 权限说明

管理员须拥有“操作通讯录”的接口权限，以及指定部门的管理权限。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "created" 
    4. } 

2、更新成员



  • 请求说明

Https请求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/user/update?access_token=ACCESS_TOKEN


请求包示例如下（如果非必须的字段未指定，则不更新该字段之前的设置值）:

  1. { 
  2.    "userid": "zhangsan", 
  3.    "name": "李四", 
  4.    "department": [1], 
  5.    "position": "后台工程师", 
  6.    "mobile": "15913215421", 
  7.    "gender": 1, 
  8.    "tel": "62394", 
  9.    "email": "zhangsan@gzdev.com", 
  10.    "weixinid": "lisifordev", 
  11.    "enable": 1 
  12. } 


  • 参数说明


















































参数 必须 说明
access_token 是 调用接口凭证
userid 是 员工UserID。对应管理端的帐号，企业内必须唯一
name 否 成员名称。长度为0~64个字符
department 否 成员所属部门id列表。注意，每个部门的直属员工上限为1000个
position 否 职位信息。长度为0~64个字符
mobile 否 手机号码。企业内必须唯一，更新后的成员mobile/weixinid/email三者不能同时为空
gender 否 性别。gender=0表示男，=1表示女。默认gender=0
tel 否 办公电话。长度为0~64个字符。必须企业内唯一
email 否 邮箱。长度为0~64个字符。企业内必须唯一
weixinid 否 微信号。企业内必须唯一
enable 否 启用/禁用成员。1表示启用成员，0表示禁用成员


  • 权限说明

管理员须拥有“操作通讯录”的接口权限，以及指定部门、成员的管理权限。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "updated" 
    4. } 

3、删除成员



  • 请求说明

Https请求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/user/delete?access_token=ACCESS_TOKEN&userid=lisi



  • 参数说明














参数 必须 说明
access_token 是 调用接口凭证
userid 是 员工UserID。对应管理端的帐号


  • 权限说明

管理员须拥有“操作通讯录”的接口权限，以及指定部门、成员的管理权限。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "deleted" 
    4. } 

4、获取成员



  • 请求说明

Https请求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&userid=lisi



  • 参数说明














参数 必须 说明
access_token 是 调用接口凭证
userid 是 员工UserID


  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "ok", 
    4.    "userid": "zhangsan", 
    5.    "name": "李四", 
    6.    "department": [1, 2], 
    7.    "position": "后台工程师", 
    8.    "mobile": "15913215421", 
    9.    "gender": 1, 
    10.    "tel": "62394", 
    11.    "email": "zhangsan@gzdev.com", 
    12.    "weixinid": "lisifordev",   
    13.    "avatar": "http://wx.qlogo.cn/mmopen/ajNVdqHZLLA3WJ6DSZUfiakYe37PKnQhBIeOQBO4czqrnZDS79FH5Wm5m4X69TBicnHFlhiafvDwklOpZeXYQQ2icg/0", 
    14.    "status": 1 
    15. } 












































参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
userid 员工UserID
name 成员名称
department 成员所属部门id列表
position 职位信息
mobile 手机号码
gender 性别。gender=0表示男，=1表示女
tel 办公电话
email 邮箱
weixinid 微信号
avatar 头像url。注：如果要获取小图将url最后的"/0"改成"/64"即可
status 关注状态: 1=已关注，2=已冻结，4=未关注


  • 权限说明

管理员须拥有’获取成员’的接口权限，以及成员的查看权限。


5、获取部门成员



  • 请求说明

Https请求方式: GET


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



  • 参数说明






















参数 必须 说明
access_token 是 调用接口凭证
department_id 是 获取的部门id
fetch_child 否 1/0：是否递归获取子部门下面的成员
status 否 0获取全部员工，1获取已关注成员列表，2获取禁用成员列表，4获取未关注成员列表。status可叠加


  • 权限说明

管理员须拥有’获取部门成员’的接口权限，以及指定部门的查看权限。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "ok", 
    4.    "userlist": [ 
    5.            { 
    6.                   "userid": "zhangsan", 
    7.                   "name": "李四" 
    8.            } 
    9.      ] 
    10. } 




















参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
userlist 成员列表
userid 员工UserID
name 成员名称


三、管理标签


1、创建标签



  • 请求说明

Https请求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token=ACCESS_TOKEN


注：标签锁默认为未加锁状态


请求包结构体为:

  1. { 
  2.    "tagname": "UI" 
  3. } 


  • 参数说明














参数 必须 说明
access_token 是 调用接口凭证
tagname 是 标签名称。长度为1~64个字符，标签不可与其他同组的标签重名，也不可与全局标签重名


  • 权限说明

无限定。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "created" 
    4.    "tagid": "1" 
    5. } 

2、更新标签名字



  • 请求说明

Https请求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/tag/update?access_token=ACCESS_TOKEN


请求包示例如下:

  1. { 
  2.    "tagid": "1", 
  3.    "tagname": "UI design" 
  4. } 


  • 参数说明


















参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID
tagname 是 标签名称。最长64个字符


  • 权限说明

管理员必须是指定标签的创建者。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "updated" 
    4. } 

3、删除标签



  • 请求说明

Https请求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/tag/delete?access_token=ACCESS_TOKEN&tagid=1



  • 参数说明














参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID


  • 权限说明

管理员必须是指定标签的创建者，并且标签的成员列表为空。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "deleted" 
    4. } 

4、获取标签成员



  • 请求说明

Https请求方式: GET


https://qyapi.weixin.qq.com/cgi-bin/tag/get?access_token=ACCESS_TOKEN&tagid=1



  • 参数说明














参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID


  • 权限说明

管理员须拥有“获取标签成员”的接口权限，标签须对管理员可见；返回列表仅包含管理员管辖范围的成员。



  • 返回结果 
    1. { 
    2.    "errcode": 0, 
    3.    "errmsg": "ok", 
    4.    "userlist": [ 
    5.          { 
    6.              "userid": "zhangsan", 
    7.              "name": "李四" 
    8.          } 
    9.      ] 
    10. } 

















参数 说明
errcode 错误码
errmsg 错误消息
userlist 成员列表
userid 员工UserID

5、增加标签成员



  • 请求说明

Https请求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/tag/addtagusers?access_token=ACCESS_TOKEN


请求包示例如下:

  1. { 
  2.    "tagid": "1", 
  3.    "userlist":[ "user1","user2"] 
  4. } 


  • 参数说明


















参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID
userlist 是 企业员工ID列表


  • 权限说明

标签对管理员可见且未加锁，成员属于管理员管辖范围。



  • 返回结果

a)正确时返回

  1. { 
  2.    "errcode": 0, 
  3.    "errmsg": "ok" 
  4. } 

b)若部分userid非法，则返回

  1. { 
  2.    "errcode": 0, 
  3.    "errmsg": "invalid userlist failed" 
  4.    "invalidlist"："usr1|usr2|usr" 
  5. } 

c)当包含userid全部非法时返回

  1. { 
  2.    "errcode": 40070, 
  3.    "errmsg": "all list invalid " 
  4. } 














参数 说明
errcode 错误码
errmsg 错误消息
invalidlist 不在权限内的员工ID列表，以“|”分隔

6、删除标签成员



  • 请求说明

Https请求方式: POST


https://qyapi.weixin.qq.com/cgi-bin/tag/deltagusers?access_token=ACCESS_TOKEN


请求包如下

  1. { 
  2.    "tagid": "1", 
  3.    "userlist":[ "user1","user2"] 
  4. } 


  • 参数说明


















参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID
userlist 是 企业员工ID列表


  • 权限说明

标签对管理员可见且未加锁，成员属于管理员管辖范围。



  • 返回结果

a)正确时返回

  1. { 
  2.    "errcode": 0, 
  3.    "errmsg": "deleted" 
  4. } 

b)若部分userid非法，则返回

  1. { 
  2.    "errcode": 0, 
  3.    "errmsg": "invalid userlist failed" 
  4.    "invalidlist"："usr1|usr2|usr" 
  5. } 

c)当包含的userid全部非法时返回

  1. { 
  2.    "errcode": 40031, 
  3.    "errmsg": "all list invalid" 
  4. } 














参数 说明
errcode 错误码
errmsg 错误消息
invalidlist 不在权限内的或者非法的员工ID列表，以“|”分隔

该文章在 2014/12/2 0:47:33 编辑过
关键字查询
相关文章
正在查询...
点晴ERP是一款针对中小制造业的专业生产管理软件系统,系统成熟度和易用性得到了国内大量中小企业的青睐。
点晴PMS码头管理系统主要针对港口码头集装箱与散货日常运作、调度、堆场、车队、财务费用、相关报表等业务管理，结合码头的业务特点，围绕调度、堆场作业而开发的。集技术的先进性、管理的有效性于一体，是物流码头及其他港口类企业的高效ERP管理信息系统。
点晴WMS仓储管理系统提供了货物产品管理,销售管理,采购管理,仓储管理,仓库管理,保质期管理,货位管理,库位管理,生产管理,WMS管理系统,标签打印,条形码,二维码管理,批号管理软件。
点晴免费OA是一款软件和通用服务都免费，不限功能、不限时间、不限用户的免费OA协同办公管理系统。
Copyright 2010-2024 ClickSun All Rights Reserved