# 编辑联系人状态


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

Content-Type: application/json
```
**接口限制**：每分钟调用600次；

**使用说明**：员工跟进状态为名称匹配，若出现重名，则以匹配到的第一个作为标准


**Params:**

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

**请求参数**

| 请求参数名                   | 类型       | 说明                                             | 是否必须 |
| ---------------------------- | ---------- | ------------------------------------------------ | -------- |
| customer_list                | `Object[]` | 联系人列表（最大支持200个）                      | true     |
| customer_list.id             | `String`   | 联系人id                                         | true     |
| customer_list.status_name    | `String`   | 跟进状态名称                                     | true     |
| customer_list.invalid_reason | `String`   | 无效原因(支持名称和id匹配，跟进状态为无效时必填) | false    |

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

```json
{
    "customer_list": [
        {
            "id": "86a92f5e-1521-11ec-bdd0-3e4a6ace5672",
            "status_name": "成单"
        }
    ]
}
```

**成功响应**

| 响应参数名   | 类型     | 说明                         |
| ------------ | -------- | ---------------------------- |
| code         | `Int`    | 响应码                       |
| msg          | `String` | 消息提示                     |
| success      | `Bool`   | 是否成功                     |
| data         | `Object` | 响应数据                     |
| data.id      | `String` | 联系人id                     |
| data.code    | `Int`    | 失败的code码                 |
| data.index   | `Int`    | 失败的index索引，0为起始索引 |
| data.message | `String` | 失败文案                     |

**成功响应示例**

```json
{
    "success": true,
    "msg": "",
    "data": null
}
```

**错误响应示例**

```json
{
    "success": false,
    "code": 21004,
    "msg": "",
    "data": {
        "code": 21004,
        "id": "86a92f5e-1521-11ec-bdd0-3e4a6ace5672",
        "index": 0,
        "message": "跟进状态：跟进状态名称,不存在"
    }
}
```