探马OpenAPI

个人待分配客户导入

POST

/api/v3/add-unassigned

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

customerName

string

客户姓名

必需

salesStage

number

客户阶段

可选

mobiles

array[string]

客户手机号列表

必需

fields

array [object {2}] | null

客户字段列表

可选

alias

string | null

字段映射别名

可选

第三方系统字段标识，参考：第三方数据字段和探马字段映射关系，若填写时，需同时填写字段映射与字段值

fieldValue

string | null

字段值

可选

单行文本、多行文本、数值类型, 直接展示为其字面值。
日期类型格式 yyyy-MM-dd。
日期时间类型格式 yyyy-MM-dd HH:mm:ss。
手机号，则展示为 JSON 数组字面值，如 ["18317177777","18317178888"]。
单选，展示为选项列 id 值。
多选，展示为选项列 id JSON 数组字面值，如"[1,2,3]"。若填写时，需同时填写字段映射与字段值

示例

{
  "customerName": "tanmarket",
  "mobiles": [
    "18125780876",
    "13296666672",
    "18109888906",
    "19852183554"
  ],
  "fields": [
    {
      "alias": "单行文本",
      "fieldValue": "incididunt dolore pariatur"
    },
    {
      "alias": "多选",
      "fieldValue": "[1,2,3]"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/add-unassigned' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerName": "tanmarket",
    "mobiles": [
        "18125780876",
        "13296666672",
        "18109888906",
        "19852183554"
    ],
    "fields": [
        {
            "alias": "单行文本",
            "fieldValue": "incididunt dolore pariatur"
        },
        {
            "alias": "多选",
            "fieldValue": "[1,2,3]"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

业务状态码

必需

message

string

消息

必需

data

number

探马内部的客户id

必需

导入成功，返回客户id

示例

成功示例异常示例

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

🟢200异常

个人线索导入

个人客户导入