公海-企业客户批量更新

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

公海-个人客户批量更新

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