创建联系人

POST

/api/v3/contacts/create

根据customerId、salesId，contacts联系人字段集合创建联系人。接口会返回错误信息，创建成功的联系人将会返回联系人id及手机号信息。

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

customerId

number

企业客户id

必需

salesId

number

员工id

必需

contacts

array [object {1}]

联系人

必需

fields

array [object {2}]

联系人字段信息

必需

示例

{
    "customerId": 478452324988992,
    "salesId": 463352988837952,
    "contacts": [
        {
            "fields": [
                {
                    "id": 2743,
                    "value": [
                        "北京市/北京市/海淀区"
                    ]
                },
                {
                    "id": 920,
                    "value": [
                        "2022-06-01"
                    ]
                },
                {
                    "id": 916,
                    "value": [
                        "0719联系人01"
                    ]
                },
                {
                    "id": 913,
                    "value": [
                        "207191159001"
                    ]
                },
                {
                    "id": 3996,
                    "value": [
                        "207191159001"
                    ]
                },
                {
                    "id": 915,
                    "value": [
                        "120002000测试描述瞎填915测试描述瞎填9152"
                    ]
                }
            ]
        },
        {
            "fields": [
                {
                    "id": 2743,
                    "value": [
                        "北京市/北京市/海淀区"
                    ]
                },
                {
                    "id": 920,
                    "value": [
                        "2022-06-02"
                    ]
                },
                {
                    "id": 916,
                    "value": [
                        "0719联系人02"
                    ]
                },
                {
                    "id": 913,
                    "value": [
                        "207191159002"
                    ]
                },
                {
                    "id": 3996,
                    "value": [
                        "207191159002"
                    ]
                },
                {
                    "id": 915,
                    "value": [
                        "220002000测试描述瞎填915测试描述瞎填9152"
                    ]
                }
            ]
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/contacts/create' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerId": 478452324988992,
    "salesId": 463352988837952,
    "contacts": [
        {
            "fields": [
                {
                    "id": 2743,
                    "value": [
                        "北京市/北京市/海淀区"
                    ]
                },
                {
                    "id": 920,
                    "value": [
                        "2022-06-01"
                    ]
                },
                {
                    "id": 916,
                    "value": [
                        "0719联系人01"
                    ]
                },
                {
                    "id": 913,
                    "value": [
                        "207191159001"
                    ]
                },
                {
                    "id": 3996,
                    "value": [
                        "207191159001"
                    ]
                },
                {
                    "id": 915,
                    "value": [
                        "120002000测试描述瞎填915测试描述瞎填9152"
                    ]
                }
            ]
        },
        {
            "fields": [
                {
                    "id": 2743,
                    "value": [
                        "北京市/北京市/海淀区"
                    ]
                },
                {
                    "id": 920,
                    "value": [
                        "2022-06-02"
                    ]
                },
                {
                    "id": 916,
                    "value": [
                        "0719联系人02"
                    ]
                },
                {
                    "id": 913,
                    "value": [
                        "207191159002"
                    ]
                },
                {
                    "id": 3996,
                    "value": [
                        "207191159002"
                    ]
                },
                {
                    "id": 915,
                    "value": [
                        "220002000测试描述瞎填915测试描述瞎填9152"
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

errId

integer

可选

contacts

object

可选

示例

成功示例成功示例 -有错误信息异常示例

{
    "code": 0,
    "message": "success",
    "data": {
        "contacts": {
            "487931210678272": [
                "207191159010"
            ],
            "487931207669760": [
                "207191159004"
            ],
            "487931209789440": [
                "207191159008"
            ],
            "487931199510528": [
                "207191159001"
            ],
            "487931206617088": [
                "207191159002"
            ],
            "487931210237952": [
                "207191159009"
            ],
            "487931207219200": [
                "207191159003"
            ],
            "487931209170944": [
                "207191159007"
            ],
            "487931208071168": [
                "207191159005"
            ],
            "487931208454144": [
                "207191159006"
            ]
        }
    }
}

修改于 2022-07-27 03:15:42

查询联系人

修改联系人