# 绑定外部ID与联系人ID


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

Content-Type: application/json
```

**接口限制**：每分钟调用600次，单次上限500条

**注**：当参数inside_id和tel，同时传参，默认以inside_id为准，响应参数index为按照参数顺序计数索引，从0开始计数。当code码为13024，响应字段external_id为当前系统尘锋客户ID已经关联的外部客户ID；当code码为13025，响应字段inside_id为当前系统外部客户ID已经关联的尘锋客户ID。

**Params:**

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

**请求参数**

| 请求参数名       | 类型       | 说明                          | 是否必须 |
| ---------------- | ---------- | ----------------------------- | -------- |
| list             | `Object[]` | 客户列表，单次数据量上限500   | true     |
| list.external_id | `String`   | 外部客户id                    | true     |
| list.tel         | `String`   | 电话（和inside_id二选一必填） | false    |
| list.inside_id   | `String`   | 尘锋客户id（和tel二选一必填） | false    |

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

```json
{
    "list": [
        {
            "external_id": "100004",
            "inside_id": "60ee3s0e-1111-1111-1111-8258f1997f4e"
        },{
            "external_id": "100003",
             "inside_id": "69ee370e-1111-1111-1111-8258f1797f4e"
        },{
            "external_id": "100000",
            "tel": "18200000000"
        }
    ]
}
```

**成功响应**

| 响应参数名               | 类型       | 说明                                             |
| ------------------------ | ---------- | ------------------------------------------------ |
| code                     | `Int`      | 响应码                                           |
| msg                      | `String`   | 消息提示                                         |
| success                  | `Bool`     | 是否成功                                         |
| data                     | `Object[]` | 返回数据                                         |
| data.success             | `Object[]` | 成功数据                                         |
| data.success.index       | `Int`      | 索引                                             |
| data.success.inside_id   | `String`   | 尘锋客户ID                                       |
| data.success.external_id | `String`   | 外部客户ID                                       |
| data.fail                | `Object[]` | 失败数据                                         |
| data.fail.index          | `Int`      | 索引                                             |
| data.fail.inside_id      | `String`   | 尘锋客户ID                                       |
| data.fail.external_id    | `String`   | 外部客户ID                                       |
| data.fail.code           | `Int`      | 失败code码                                       |
| data.fail.msg            | `String`   | 失败原因描述                                     |
| data.fail.exist_cus_ids  | `String[]` | 存在多个同号码联系人，最多返回1000个尘锋联系人ID |
| data.fail.repeat_index   | `Int`      | 与内部重复索引，批次内部重复，与之重复的索引序号 |

**成功响应示例**

```json
{
    "success": true,
    "msg": "",
    "data": {
        "fail": null,
        "success": [
            {
                "external_id": "100003",
                "index": 0,
                "inside_id": "69ee370e-1111-1111-1111-8258f1797f4e"
            }
        ]
    }
}
```

**错误响应示例**


```json
{
    "success": false,
    "msg": "",
    "data": {
        "fail": [
            {
                "code": 13025,
                "exist_cus_ids": null,
                "external_id": "100003",
                "index": 1,
                "inside_id": "69ee370e-1111-1111-1111-8258f1797f4e",
                "msg": "外部ID已被其他客户绑定",
                "repeat_index": 0
            },
            {
                "code": 13026,
                "exist_cus_ids": [
                    "69ee370e-1111-1111-1111-8258f1797f4e",
                    "210624b9-1111-1111-1111-0242ac110011"
                ],
                "external_id": "100000",
                "index": 2,
                "inside_id": "",
                "msg": "电话号码匹配到多个联系人",
                "repeat_index": 0
            }
        ],
        "success": [
             {
                 "external_id": "100004",
                 "index": 0,
                 "inside_id": "60ee3s0e-1111-1111-1111-8258f1997f4e"
             }
        ]
    }
}
```