群标签-查询标签集合

最后更新: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值大的排序靠前

results matching ""

    No results matching ""