查询好友标签列表 - 尘锋SCRM开放平台

接口返回配置中心标签管理中的好友标签列表，可用于联系人字段"好友标签"的映射关系建立

POST https://qw-openapi-tx.dustess.com/customer/v1/getCustomerTagList?accessToken=

接口限制：每分钟调用600次；

请求header

字段	值
Content-Type	application/json

Params:

字段	类型	描述	是否必须
accessToken	`String`	accessToken	true

请求参数

请求参数名	类型	说明	是否必须
group_id	`String[]`	要查询的标签组ID列表	false
group_name	`String`	要查询的标签组名称，支持模糊查询	false
tag_id	`String[]`	要查询的标签ID列表	false
tag_name	`String`	要查询的标签名称，支持模糊查询	false

请求参数说明:

所有入参不传则返回所有标签

请求参数示例

{
    "group_id": [
        "etxxxx",
        "etyyyy"
    ],
    "group_name": "标签组一",
    "tag_id": [
        "etzzzz",
        "etaaaa"
    ],
    "tag_name": "标签一"
}

成功响应

响应参数名	类型	说明
success	`Bool`	是否成功
code	`Int`	响应码
msg	`String`	消息提示
data	`Object`	返回数据
data.tag_group	`Object[]`	标签组列表
data.tag_group.group_id	`String`	标签组ID
data.tag_group.group_name	`String`	标签组名称
data.tag_group.create_time	`Int`	标签组创建时间
data.tag_group.order	`Int`	标签组次序值。order值大的排序靠前
data.tag_group.deleted	`Bool`	标签组是否已删除
data.tag_group.tag	`Object[]`	标签组成员标签
data.tag_group.tag.id	`String`	标签名称
data.tag_group.tag.name	`String`	标签名称
data.tag_group.tag.create_time	`Int`	标签创建时间
data.tag_group.tag.order	`Int`	标签次序值。order值大的排序靠前
data.tag_group.tag.deleted	`Bool`	标签是否已删除

成功响应示例

{
    "success": true,
    "code": 0,
    "msg": "OK",
    "data": {
        "tag_group": [
            {
                "group_id": "etxxxx",
                "group_name": "标签组一",
                "create_time": 1650265732,
                "order": 1000,
                "deleted": false,
                "tag": [
                    {
                        "id": "etyyyy",
                        "name": "标签一",
                        "create_time": 1650265732,
                        "order": 1000,
                        "deleted": false
                    }
                ]
            }
        ]
    }
}