通讯录同步相关接口,可以对部门、成员、标签等通讯录信息进行查询、添加、修改、删除等操作。本次我们主要说下通讯录管理中的标签管理, 主要从一下几个接口说明:
1. 创建标签
2. 更新标签名字
3. 删除标签
4. 获取标签成员
5. 增加标签成员
6. 删除标签成员
7. 获取标签列表
创建标签
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/tag/create?access_token=ACCESS_TOKEN
请求包体:
[C#] 纯文本查看 复制代码
{
"tagname": "UI",
"tagid": 12
}
请求参数说明:
[C#] 纯文本查看 复制代码
参数 必须 说明
1. access_token 是 调用接口凭证
2. tagname 是 标签名称,长度限制为32个字以内(汉字或英文字母),标签名不可与其他标签重名。
3. tagid 否 标签id,非负整型,指定此参数时新增的标签会生成对应的标签id,不指定时则以目前最大的id自增。
请求返回结果:
[C#] 纯文本查看 复制代码
{
"errcode": 0,
"errmsg": "created"
"tagid": 12
}
请求返回结果参数说明:
[C#] 纯文本查看 复制代码
参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
tagid 标签id
权限说明: 创建的标签属于该应用,只有该应用的secret才可以增删成员。 注意,标签总数不能超过3000个。
|