企业微信接口-管理企业标签

来源: 管理企业标签 - 文档 - 企业微信开发者中心 (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 协议 ,转载请注明出处!