通讯录同步相关接口,可以对部门、成员、标签等通讯录信息进行查询、添加、修改、删除等操作。本次我们主要说下通讯录管理中的标签管理, 主要从一下几个接口说明:
1. 创建标签
2. 更新标签名字
3. 删除标签
4. 获取标签成员
5. 增加标签成员
6. 删除标签成员
7. 获取标签列表
获取标签成员
请求方式:GET(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/tag/get?access_token=ACCESS_TOKEN&tagid=TAGID
请求参数说明:
[C#] 纯文本查看 复制代码
参数 必须 说明
access_token 是 调用接口凭证
tagid 是 标签ID
请求返回结果:
[C#] 纯文本查看 复制代码
{
"errcode": 0,
"errmsg": "ok",
"tagname": "乒乓球协会",
"userlist": [
{
"userid": "zhangsan",
"name": "李四"
}
],
"partylist": [2]
}
请求返回结果参数说明:
[C#] 纯文本查看 复制代码
参数 说明
1. errcode 返回码
2. errmsg 对返回码的文本描述内容
3. tagname 标签名
4. userlist 标签中包含的成员列表
5. userid 成员帐号
6. name 成员名称,代开发自建应用需要管理员授权才返回该字段;此字段从2019年12月30日起,对新创建第三方应用不再返回,2020年6月30日起,对所有历史第三方应用不再返回,后续第三方仅通讯录应用可获取,未返回名称的情况需要通过通讯录展示组件来展示名字
7. partylist 标签中包含的部门id列表
权限说明: 无限制,但返回列表仅包含应用可见范围的成员;第三方可获取自己创建的标签及应用可见范围内的标签详情
|