探马OpenAPI

个人线索导入

POST

/api/v3/add-clue

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

customerName

string

线索姓名

必需

mobiles

array[string]

线索手机号列表

必需

fields

array [object {2}] | null

线索字段列表

可选

alias

string | null

字段映射别名

可选

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

fieldValue

string | null

字段值

可选

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

示例

{
    "customerName": "因众型不化",
    "mobiles": [
        "18111378632",
        "18640756959",
        "18189475412",
        "18682877832",
        "18666821221"
    ],
    "fields": [
        {
            "alias": "dolor dolore labore",
            "fieldValue": "exercitation enim in nulla"
        },
        {
            "alias": "pariatur nostrud sit nisi Lorem",
            "fieldValue": "adipisicing amet et"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/add-clue' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerName": "因众型不化",
    "mobiles": [
        "18111378632",
        "18640756959",
        "18189475412",
        "18682877832",
        "18666821221"
    ],
    "fields": [
        {
            "alias": "dolor dolore labore",
            "fieldValue": "exercitation enim in nulla"
        },
        {
            "alias": "pariatur nostrud sit nisi Lorem",
            "fieldValue": "adipisicing amet et"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

message

string

结果说明

必需

data

number

探马客户id

必需

示例

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

🟢200异常

修改于 2023-01-03 06:07:49

客户字段映射

个人待分配客户导入