群标签-查询标签集合
最后更新:2025/12/22企业可通过此接口查询群标签组及标签信息列表
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/tag/chat_tag/query_tag_group_list?access_token=x
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 调用接口凭证 |
参数示例:
{
"keyword": "VIP",
"tag_ids": ["67890", "67891"],
"tag_group_ids": ["12345"],
"search_tag_types": ["INTERIOR_TAG"]
}
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 否 | 搜索关键词,支持模糊匹配标签组名称或标签名称 |
| tag_ids | array | 否 | 标签ID集合 |
| tag_group_ids | array | 否 | 标签组ID集合 |
| search_tag_types | array | 否 | 查询标签类型列表,如:["INTERIOR_TAG"] |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": [
{
"group_id": "12345",
"group_name": "群分类",
"create_time": 1665743354,
"order": 1000,
"tag_list": [
{
"id": "67890",
"name": "VIP客户群",
"create_time": 1665743354,
"order": 1000
},
{
"id": "67891",
"name": "普通客户群",
"create_time": 1665743355,
"order": 999
}
]
}
]
}
返回说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | int | 出错返回码,为0表示成功,非0表示调用失败 |
| msg | string | 返回码描述 |
| data | array | 标签组列表 |
| group_id | string | 标签组ID |
| group_name | string | 标签组名称 |
| create_time | long | 标签组创建时间(时间戳:秒) |
| order | long | 标签组排序值,order值大的排序靠前 |
| tag_list | object[] | 标签列表 |
| id | string | 标签ID |
| name | string | 标签名称 |
| create_time | long | 标签创建时间(时间戳:秒) |
| order | long | 标签排序值,order值大的排序靠前 |