查询内部标签组集合接口
最后更新:2024/07/11企业可通过此接口查询内部标签组信息集合。
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/tag/query_interior_tag_group_info_list?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"keyword": "test_3237fd10d53b",
"tag_ids": [
"test_86f65810228b"
],
"tag_group_ids": [
"test_88d8930368ce"
]
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
keyword | string | 否 | 搜索关键字 |
tag_ids | array | 否 | 标签id集合,当同时传入tag_ids和tag_group_ids时, 忽略tag_ids,仅以tag_group_ids作为过滤条件 |
tag_group_ids | array | 否 | 标签组id集合 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": [
{
"group_id": "TAG_GROUPID1",
"group_name": "GOURP_NAME",
"create_time": 1557838797,
"order": 1,
"tag_list": [
{
"id": "TAG_ID1",
"name": "NAME1",
"create_time": 1557838797,
"order": 1
},
{
"id": "TAG_ID2",
"name": "NAME2",
"create_time": 1557838797,
"order": 2
}
]
}
]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | object[] | 返回数据 |
group_id | string | 标签组id |
group_name | string | 标签组名称 |
create_time | long | 创建时间 |
order | int | 排序 |
tag_list | Tag[] | 标签 |
id | string | 标签id |
name | string | 标签名称 |
create_time | long | 创建时间 |
order | int | 排序 |
PS:内部标签不会同步到企业微信,返回的标签组id及标签id均为本应用体系内的id,仅支持在本应用内api里使用