# 给联系人打标签

> 编辑联系人好友标签和联系人标签，通过该接口新增和移除联系人的好友标签和联系人标签

```
POST https://qw-openapi-tx.dustess.com/open-integration-api/customer/v1/updateTags?accessToken=

Content-Type: application/json
```

**接口限制**：单次最多操作500个联系人，每分钟调用300次；

**Params:**

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

**请求参数**

| 请求参数名          | 类型       | 说明                                           | 是否必须 |
| ------------------- | ---------- | ---------------------------------------------- | -------- |
| list                | `Object[]` | 更新数据列表，最多500条                        | true     |
| list.customerId     | `String`   | 联系人id                                       | true     |
| list.tags           | `Object`   | 更新的好友标签信息（与联系人标签不能同时为空） | false    |
| list.tags.add       | `String[]` | 添加的好友标签id列表                           | false    |
| list.tags.remove    | `String[]` | 移除的好友标签id列表                           | false    |
| list.bizTags        | `Object `  | 更新的联系人标签信息（与好友标签不能同时为空） | false    |
| list.bizTags.add    | `String[]` | 添加的联系人标签id列表                         | false    |
| list.bizTags.remove | `String[]` | 移除的联系人标签id列表                         | false    |

**请求参数示例**
`json` - Request-Example1:

```json
{
    "list": [{
        "customerId": "b5a48cc7-d94d-11eb-8a97-ee6659fc100f",
        "tags": {
            "add": ["bc8aea7c-6fc5-11ed-bdab-1e80c02e3484"],
            "remove": []
        },
        "bizTags": {
            "add": [],
            "remove": ["bc8aea7c-6fc5-11ed-bdab-1e80c02e3484"]
        }
    }]
}
```

**成功响应**

| 响应参数名 | 类型       | 说明              |
| ---------- | ---------- | ----------------- |
| code       | `Int`      | 响应码 0:成功     |
| msg        | `String`   | 消息提示          |
| success    | `Bool`     | 请求成功与否      |
| data       | `Object[]` | 数据信息          |
| data.id    | `String`   | 联系人id          |
| data.code  | `String`   | 操作结果码 0:成功 |
| data.msg   | `String`   | 操作结果提示      |

**成功响应示例**

```json
{
    "code": 0,
    "success":true,
    "msg":"",
    "data":[
        {
            "id":"5f61784904a7059c9c111111",
            "code":0,
            "msg":"success"
        },
        {
            "id":"5f61784904a7059c9c111112",
            "code":20070408,
            "msg":"联系人好友标签不存在"
        }
    ]
}
```

**错误响应示例**

```json
 {
    "success": false,
    "code": 10001,
    "msg": "system unknown error",
    "data": null
}
```