公海-企业客户批量更新

POST

/api/v3/update-corp-highseas

公海企业客户批量更新。
userId为探马系统销售ID
customerId为探马系统客户ID
更新联系人信息需传入 contactId ，可通过"查询公海销售对应客户的联系人信息" 接口查询客户联系人信息。
系统暂不维护“详细地址”字段。
对于符号类型，仅允许以下定义符号：
-_`~!@#$%^&*()+=|{}':;,[].<>/?！￥…（）—【】‘；：”“’。，、？

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

array of:

userId

integer

探马系统销售ID

必需

探马系统销售ID。

customerId

integer

探马系统客户ID

必需

探马系统客户ID。

customerRepoId

string

公海库

必需

fields

array [object {2}]

企业字段

可选

系统暂不维护“详细地址”字段

integer

字段id

必需

value

array[string]

字段value

必需

customer

object

客户信息

可选

fields

array [object {2}]

企业客户字段列表

必需

系统暂不维护“详细地址”字段

contactId

integer

联系人id

必需

contacts

array [object {2}]

企业客户联系人

可选

contactId

integer

联系人id

必需

探马系统联系人ID。可根据 “查询销售对应客户的联系人信息” 接口获取

fields

array [object {2}]

企业客户联系人字段

必需

系统暂不维护“详细地址”字段

示例

[{
	"userId": 0,
	"customerId": 457531503042560,
	"customerRepoId": "416113232961600",
	"fields": [{
		"id": 1732,
		"value": ["10000人以上"]
	}, {
		"id": 1729,
		"value": ["企业全称测试去重"]
	}, {
		"id": 2918,
		"value": ["0211000000"]
	}],
	"customer": {
		"fields": [{
			"id": 913,
			"value": ["0211000001"]
		}, {
			"id": 920,
			"value": ["2022-02-11"]
		}, {
			"id": -1,
			"value": ["fan阶段1"]
		}, {
			"id": 917,
			"value": ["A1"]
		}, {
			"id": 2743,
			"value": ["北京市/北京市/海淀区"]
		}]
	},
	"contacts": [{
		"contactId": 457531503044608,
		"fields": [{
			"id": 916,
			"value": ["0211联系人"]
		}, {
			"id": 913,
			"value": ["0211000002"]
		}, {
			"id": 2743,
			"value": ["北京市/北京市/海淀区"]
		}, {
			"id": 920,
			"value": ["2022-02-11"]
		}]
	}]
}, {
	"userId": 0,
	"customerId": 457531503042560,
	"customerRepoId": "416113232961600",
	"fields": [{
		"id": 1732,
		"value": ["10000人以上"]
	}, {
		"id": 1729,
		"value": ["企业全称测试去重1111"]
	}, {
		"id": 2918,
		"value": ["20220130110100"]
	}],
	"customer": {
		"contactId": 457531503044608,
		"fields": [{
			"id": 913,
			"value": ["20220130110101"]
		}, {
			"id": 920,
			"value": ["2022-01-30"]
		}, {
			"id": -1,
			"value": ["fan阶段1"]
		}, {
			"id": 917,
			"value": ["A1"]
		}, {
			"id": 2743,
			"value": ["北京市/北京市/海淀区"]
		}]
	},
	"contacts": [{
		"contactId": 457531503044608,
		"fields": [{
			"id": 916,
			"value": ["202201192140"]
		}, {
			"id": 913,
			"value": ["20220130110102"]
		}, {
			"id": 2743,
			"value": ["北京市/北京市/海淀区"]
		}, {
			"id": 920,
			"value": ["2022-01-30"]
		}]
	}]
}]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/update-corp-highseas' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '[{
	"userId": 0,
	"customerId": 457531503042560,
	"customerRepoId": "416113232961600",
	"fields": [{
		"id": 1732,
		"value": ["10000人以上"]
	}, {
		"id": 1729,
		"value": ["企业全称测试去重"]
	}, {
		"id": 2918,
		"value": ["0211000000"]
	}],
	"customer": {
		"fields": [{
			"id": 913,
			"value": ["0211000001"]
		}, {
			"id": 920,
			"value": ["2022-02-11"]
		}, {
			"id": -1,
			"value": ["fan阶段1"]
		}, {
			"id": 917,
			"value": ["A1"]
		}, {
			"id": 2743,
			"value": ["北京市/北京市/海淀区"]
		}]
	},
	"contacts": [{
		"contactId": 457531503044608,
		"fields": [{
			"id": 916,
			"value": ["0211联系人"]
		}, {
			"id": 913,
			"value": ["0211000002"]
		}, {
			"id": 2743,
			"value": ["北京市/北京市/海淀区"]
		}, {
			"id": 920,
			"value": ["2022-02-11"]
		}]
	}]
}, {
	"userId": 0,
	"customerId": 457531503042560,
	"customerRepoId": "416113232961600",
	"fields": [{
		"id": 1732,
		"value": ["10000人以上"]
	}, {
		"id": 1729,
		"value": ["企业全称测试去重1111"]
	}, {
		"id": 2918,
		"value": ["20220130110100"]
	}],
	"customer": {
		"contactId": 457531503044608,
		"fields": [{
			"id": 913,
			"value": ["20220130110101"]
		}, {
			"id": 920,
			"value": ["2022-01-30"]
		}, {
			"id": -1,
			"value": ["fan阶段1"]
		}, {
			"id": 917,
			"value": ["A1"]
		}, {
			"id": 2743,
			"value": ["北京市/北京市/海淀区"]
		}]
	},
	"contacts": [{
		"contactId": 457531503044608,
		"fields": [{
			"id": 916,
			"value": ["202201192140"]
		}, {
			"id": 913,
			"value": ["20220130110102"]
		}, {
			"id": 2743,
			"value": ["北京市/北京市/海淀区"]
		}, {
			"id": 920,
			"value": ["2022-01-30"]
		}]
	}]
}]'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

0代表响应成功

message

string

返回描述

必需

示例

{
    "code": 0,
    "message": "success"
}

🟢200失败

修改于 2023-03-06 03:08:05

公海-个人客户批量更新

查询公海销售对应客户的联系人信息