功能说明:根据企业ID获取企业下的标签信息。
标签唯一标识码参数有两个,id和wxTagId。
如果在企业微信app中安装了道一云的通讯录,则使用道一云API接口新增标签时会同步新增到企业微信侧,wxTagId不为空。
如果未安装道一云的通讯录,新增时道一云无权限同步新增到企业微信侧,wxTagId为空;这时可使用id为标识码管理标签。
推荐安装道一云通讯录,使用wxTagId作为唯一标识码调用道一云API接口管理标签,实现道一云和企业微信的标签数据同步。
参数 | 说明 | 类型 | 是否必须 | 备注 |
---|---|---|---|---|
token
|
用于验证 | String | 是 | |
corpId
|
公司唯一标识 | String | 是 |
TagApi api = QwSdkUtil.getInter(TagApi.class); ApiGetTagListResultVO result = api.searchTag(QwSdkUtil.getCacheToken()); System.out.println(JSONUtil.stringify(result));
{ "code":"0", "data": { "tagList": [ { "deptCount":"3", "id":"sfdf808937898287esfdf", "rang":"1", "showNum":"200", "status":"0", "tagName":"标签1", "userCount":"5", "wxTagId":"1086" }, { "deptCount":"0", "id":"sfdf808937898287esfdf", "rang":"3", "showNum":"23", "status":"0", "tagName":"标签2", "userCount":"2", "wxTagId":"1087" } ] }, "desc":"成功" }
参数 |
说明 |
类型 |
---|---|---|
id |
标签ID |
string |
wxTagId | 标签微信ID | string |
tagName | 标签名 | string |
showNum | 排序号 | string |
rang | 使用范围 1.后台 3.手机端+后台 5.手机端 | string |
status | 标签状态 1.启用 0.禁用 | string |
userCount | 标签用户数量 | string |
deptCount | 标签部门数量 | string |