公海-企业客户批量导入

POST

/api/v3/save-corp-highseas

公海企业客户批量导入。接口处理失败结果可用 ”查询错误信息“ 接口查看具体信息。
系统暂不维护“详细地址”字段。
对于符号类型，仅允许以下定义符号：
-_`~!@#$%^&*()+=|{}':;,[].<>/?！￥…（）—【】‘；：”“’。，、？

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

array of:

customerRepoId

number | null

公海库

可选

如果不填是默认公海库

fields

array [object {2}]

企业字段

可选

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

integer

字段id

必需

value

array[string]

字段value

必需

customer

object | null

客户信息

可选

fields

array [object {2}]

企业客户字段

必需

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

contacts

array [object {1}] | null

企业客户联系人

可选

fields

array [object {2}]

企业客户联系人字段

可选

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

示例

[
  {
    "customerRepoId": "416113232961600",
    "fields": [
      {
        "id": 1732,
        "value": [
          "大规模"
        ]
      },
      {
        "id": 1729,
        "value": [
          "企业全称测试去重"
        ]
      },
      {
        "id": 2918,
        "value": [
          "12311122251"
        ]
      }
    ],
    "customer": {
      "fields": [
        {
          "id": 913,
          "value": [
            "012019000014"
          ]
        },
        {
          "id": 920,
          "value": [
            "2022-03-31"
          ]
        },
        {
          "id": -1,
          "value": [
            "多次成交11"
          ]
        },
        {
          "id": 917,
          "value": [
            "A1"
          ]
        },
        {
          "id": 2743,
          "value": [
            "北京市/北京市/通州区"
          ]
        }
      ]
    },
    "contacts": [
      {
        "fields": [
          {
            "id": 916,
            "value": [
              "202201192140"
            ]
          },
          {
            "id": 913,
            "value": [
              "13200556629"
            ]
          },
          {
            "id": 2743,
            "value": [
              "北京市/北京市/丰台区"
            ]
          },
          {
            "id": 920,
            "value": [
              "2022-03-31"
            ]
          }
        ]
      }
    ]
  }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/save-corp-highseas' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "customerRepoId": "416113232961600",
        "fields": [
            {
                "id": 1732,
                "value": [
                    "大规模"
                ]
            },
            {
                "id": 1729,
                "value": [
                    "企业全称测试去重"
                ]
            },
            {
                "id": 2918,
                "value": [
                    "12311122251"
                ]
            }
        ],
        "customer": {
            "fields": [
                {
                    "id": 913,
                    "value": [
                        "012019000014"
                    ]
                },
                {
                    "id": 920,
                    "value": [
                        "2022-03-31"
                    ]
                },
                {
                    "id": -1,
                    "value": [
                        "多次成交11"
                    ]
                },
                {
                    "id": 917,
                    "value": [
                        "A1"
                    ]
                },
                {
                    "id": 2743,
                    "value": [
                        "北京市/北京市/通州区"
                    ]
                }
            ]
        },
        "contacts": [
            {
                "fields": [
                    {
                        "id": 916,
                        "value": [
                            "202201192140"
                        ]
                    },
                    {
                        "id": 913,
                        "value": [
                            "13200556629"
                        ]
                    },
                    {
                        "id": 2743,
                        "value": [
                            "北京市/北京市/丰台区"
                        ]
                    },
                    {
                        "id": 920,
                        "value": [
                            "2022-03-31"
                        ]
                    }
                ]
            }
        ]
    }
]'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

0代表响应成功

message

string

返回描述

必需

示例

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

🟢200失败

修改于 2022-07-15 08:29:55

公海-个人客户批量导入

公海-个人客户批量更新