更新联系人外部ID - 尘锋SCRM开放平台

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

Content-Type: application/json

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

Params:

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

请求参数

请求参数名	类型	说明	是否必须
list	`Object[]`	客户列表，单次数据量上限500	true
list.cid	`String`	尘锋客户id（作为判重标准）	true
list.external_id	`String`	外部客户id	true

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

{
    "list": [
        {
            "cid": "fe09a8d3-f6bb-11ec-a7d7-c654fd94852e",
            "external_id": "18"
        },
        {
            "cid": "fe09a8e0-f6bb-11ec-a7d7-c654fd94852e",
            "external_id": "40"
        }
    ]
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码
msg	`String`	消息提示
success	`Bool`	是否成功
data	`Object[]`	返回数据
data.success	`Object[]`	成功数据
data.success.cid	`String`	尘锋客户ID
data.success.external_id	`String`	外部客户ID
data.fail	`Object[]`	失败数据
data.fail.cid	`String`	尘锋客户ID
data.fail.external_id	`String`	外部客户ID
data.fail.code	`Int`	失败code码
data.fail.msg	`String`	失败原因描述

成功响应示例

{
    "success": true,
    "code": 0,
    "msg": "",
    "data": {
        "success": [
            {
                "cid": "fe09a8e0-f6bb-11ec-a7d7-c654fd94852e",
                "external_id": "40"
            }
        ],
        "fail": [
            {
                "cid": "fe09a8d3-f6bb-11ec-a7d7-c654fd94852e",
                "external_id": "18",
                "code": 6000004,
                "msg": "不存在关联关系不能操作"
            }
        ]
    }
}

错误响应示例

{
    "success": false,
    "code": 10001,
    "msg": "system unknow error",
    "data": {
        "success":[],
        "fail":[]
    }
}