绑定外部ID与联系人ID - 尘锋SCRM开放平台

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:

{
    "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`	与内部重复索引，批次内部重复，与之重复的索引序号

成功响应示例

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

错误响应示例

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