公海-个人客户批量更新

POST

/api/v3/update-highseas

公海个人客户更新接口， userId与qwUserId两者必传一项。 customerId与qwCustomerId两者必传一项。
系统暂不维护“详细地址”字段。
对于符号类型，仅允许以下定义符号：
-_`~!@#$%^&*()+=|{}':;,[].<>/?！￥…（）—【】‘；：”“’。，、？

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

array of:

customerRepoId

number

公海库

必需

如果不填是默认公海库

customerId

integer

探马系统客户ID

必需

（推荐该值请求。 qwCustomerId为空时，该值必填）

userId

integer

探马系统销售ID

必需

（推荐该值请求。 qwUserId为空时，该值必填。通过api导入的公海客户，userId传0）

qwCustomerId

string

企微客户ID

可选

customerId为空时，该值必填。已传customerId，则不用传该值。

qwUserId

string

企微销售ID

可选

userId为空时，该值必填。已传userId，则不用传该值。

fields

array [object {2}]

客户字段

必需

系统暂不维护“详细地址”字段。对于符号类型：仅允许以下定义符号。 -_`~!@#$%^&*()+=|{}':;,[].<>/?！￥…（）—【】‘；：”“’。，、？

integer

字段id

必需

value

array[string]

字段value

必需

示例

[
  {
    "customerRepoId": "456101567348672",
    "customerId": 455577499396096,
    "userId": 0,
    "qwCustomerId": "wovRo3DwAABWB3gS4H44ebEd2K6Pk23Q",
    "qwUserId": "zhangsan1",
    "fields": [
      {
        "id": 916,
        "value": [
          "测试更新012102"
        ]
      },
      {
        "id": 913,
        "value": [
          "01201900003"
        ]
      },
      {
        "id": 920,
        "value": [
          "2022-03-31"
        ]
      }
    ]
  },
  {
    "customerRepoId": "456101567348672",
    "customerId": 455577499384152,
    "userId": 0,
    "qwCustomerId": "wovRo3DwAABWB3gS4H12451123K6Pk213Q",
    "qwUserId": "wangqiangT",
    "fields": [
      {
        "id": 916,
        "value": [
          "测试更新012199"
        ]
      },
      {
        "id": 913,
        "value": [
          "01201900099"
        ]
      },
      {
        "id": 920,
        "value": [
          "2022-04-30"
        ]
      },
      {
        "id": -1,
        "value": [
          "fan阶段2"
        ]
      }
    ]
  }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/update-highseas' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "customerRepoId": "456101567348672",
        "customerId": 455577499396096,
        "userId": 0,
        "qwCustomerId": "wovRo3DwAABWB3gS4H44ebEd2K6Pk23Q",
        "qwUserId": "zhangsan1",
        "fields": [
            {
                "id": 916,
                "value": [
                    "测试更新012102"
                ]
            },
            {
                "id": 913,
                "value": [
                    "01201900003"
                ]
            },
            {
                "id": 920,
                "value": [
                    "2022-03-31"
                ]
            }
        ]
    },
    {
        "customerRepoId": "456101567348672",
        "customerId": 455577499384152,
        "userId": 0,
        "qwCustomerId": "wovRo3DwAABWB3gS4H12451123K6Pk213Q",
        "qwUserId": "wangqiangT",
        "fields": [
            {
                "id": 916,
                "value": [
                    "测试更新012199"
                ]
            },
            {
                "id": 913,
                "value": [
                    "01201900099"
                ]
            },
            {
                "id": 920,
                "value": [
                    "2022-04-30"
                ]
            },
            {
                "id": -1,
                "value": [
                    "fan阶段2"
                ]
            }
        ]
    }
]'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

0代表响应成功

message

string

返回描述

必需

示例

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

🟢200失败

修改于 2022-07-15 08:30:33

公海-企业客户批量导入

公海-企业客户批量更新