查询联系人标签列表 - 尘锋SCRM开放平台

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

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

请求header

字段	值
Content-Type	application/json

Params:

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

请求参数

请求参数名	类型	说明	是否必须
deptIds	`Int[]`	部门ids	false
tagIds	`Int[]`	标签ids	false
tagName	`String`	标签名称	false
isEnable	`Bool`	标签启用状态（true-启用；false-禁用）	false
groupIds	`String[]`	标签组ids	false
groupName	`String`	标签组名称	false
groupEnable	`Bool`	标签组状态（true-启用；false-禁用）	false

请求参数示例
json - Request-Example:

{
    "deptIds":[7],
    "tagIds":["c459138d-6df6-11ec-8df6-e25c856d9493"],
    "tagName":"标签",
    "isEnable":true,
    "groupIds":["TWDAluaa"],
    "groupName":"标签组名",
    "groupEnable":true
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码
msg	`String`	消息提示
success	`Bool`	成功标识
data	`Object[]`	响应码
data.groupId	`String`	标签分组id
data.groupName	`String`	标签分组名称
data.groupEnable	`Bool`	标签分组状态（true-启用；false-禁用）
data.deptIds	`Int[]`	可使用部门ID合集
data.tagList	`Object[]`	标签列表
data.tagList.tagId	`String`	标签id
data.tagList.tagName	`String`	标签名称
data.tagList.order	`Int`	标签排序的次序值，order值⼤的排序靠前
data.tagList.isEnable	`Bool`	标签状态（true-启用；false-禁用）

成功响应示例

{
    "success": true,
    "code": 0,
    "msg": "success",
    "data": [{
        "groupId": "TWDAluaa",
        "groupName": "标签组名1626336538400",
        "groupEnable": true,
        "deptIds": [7],
        "tagList": [{
            "tagId": "c459138d-6df6-11ec-8df6-e25c856d9493",
            "tagName": "标签1231",
            "isEnable": true
        }]
    }]
}

错误响应示例

{
    "code": 40002,
    "msg": "access token invalid",
    "data": {}
}