功能说明:根据企业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 |