# 查询联系人标签列表


```
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:

```json
{
    "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-禁用）     |


**成功响应示例**

```json
{
    "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
        }]
    }]
}
```

**错误响应示例**

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