企业微信接口-管理企业标签
来源: 管理企业标签 - 文档 - 企业微信开发者中心 (qq.com)
1.获取企业标签库
企业可通过此接口获取企业客户标签详情
请求方式: POST(HTTP)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/externalcontact/get_corp_tag_list?access_token=ACCESS_TOKEN
请求示例:1
2
3
4
5
6
7
8
9
10{
"tag_id": [
"etXXXXXXXXXX",
"etYYYYYYYYYY"
],
"group_id": [
"etZZZZZZZZZZZZZ",
"etYYYYYYYYYYYYY"
]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
tag_id | 否 | 要查询的标签id |
group_id | 否 | 要查询的标签组id,返回该标签组以及其下的所有标签信息 |
若tag_id和group_id均为空,则返回所有标签。
同时传递tag_id和group_id时,忽略tag_id,仅以group_id作为过滤条件。
返回结果:1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26{
"errcode": 0,
"errmsg": "ok",
"tag_group": [{
"group_id": "TAG_GROUPID1",
"group_name": "GOURP_NAME",
"create_time": 1557838797,
"order": 1,
"deleted": false,
"tag": [{
"id": "TAG_ID1",
"name": "NAME1",
"create_time": 1557838797,
"order": 1,
"deleted": false
},
{
"id": "TAG_ID2",
"name": "NAME2",
"create_time": 1557838797,
"order": 2,
"deleted": true
}
]
}]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
tag_group | 标签组列表 |
tag_group.group_id | 标签组id |
tag_group.group_name | 标签组名称 |
tag_group.create_time | 标签组创建时间 |
tag_group.order | 标签组排序的次序值,order值大的排序靠前。有效的值范围是[0, 2^32) |
tag_group.deleted | 标签组是否已经被删除,只在指定tag_id进行查询时返回 |
tag_group.tag | 标签组内的标签列表 |
tag_group.tag.id | 标签id |
tag_group.tag.name | 标签名称 |
tag_group.tag.create_time | 标签创建时间 |
tag_group.tag.order | 标签排序的次序值,order值大的排序靠前。有效的值范围是[0, 2^32) |
tag_group.tag.deleted | 标签是否已经被删除,只在指定tag_id/group_id进行查询时返回 |
本博客所有文章除特别声明外,均采用 CC BY-SA 4.0 协议 ,转载请注明出处!