探马OpenAPI

高级筛选接口（新版）

POST

/api/v3/customer/search

提示

具体查询案例可参考：https://tanmarket.feishu.cn/docx/AbQ7dDMchoLRIWxn721cwqyBn2c

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

customerId

number

客户id

可选

searchKey

string

搜索内容

可选

企业/姓名/备注/电话

role

string

1负责人 2协作人

可选

salesIdList

array[string]

所属员工

可选

departmentIdList

array[string]

所属部门

可选

createTime

object

创建时间

可选

start

string

开始时间

必需

end

string

结束时间

必需

conditions

object

高级筛选条件

可选

conditionOp

integer

多个条件关系

必需

0 所有 1任一

conditionItems

array [object {3}]

必需

pageSize

integer

分页大小

可选

默认10，最大100

pageNo

integer

页码

可选

默认1，最大100

creditCode

string

统一社会信用代码

可选

精准匹配；该字段未启用时，搜索无效。

示例

{
    "customerId": 513799527504064,
    "searchKey": "测试",
    "role": 1
    "departmentIdList": [
        966461,
        558613
    ],
    "salesIdList": [
        5885555666,
        666666584111
    ],
    "createTime": {
        "start": "2022-12-1300:00:00",
        "end": "2022-12-19 23:59:59"
    },
    "qwCustomerTime": {
        "start": null,
        "end": null
    },
    "qwLastFollowTypes": {
        "start": null,
        "end": null
    },
    "pageNo": 1,
    "pageSize": 100,
    "conditions": {
        "conditionOp": 1,
        "conditionItems": [
            {
                "name": "contentTagIds",
                "op": 6,
                "values": [
                    "d430ec9166e511edb71d00163e06cc86:2l"
                ]
            },
            {
                "name": "tagIds",
                "op": 6,
                "values": [
                    2801078
                ]
            },
            {
                "name": "point_credit",
                "op": 7,
                "values": [
                    "11"
                ]
            },
            {
                "name": "sales_stage",
                "op": 2,
                "values": [
                    474555082656000
                ]
            },
            {
                "name": 30744,
                "op": 2,
                "values": [
                    "15135859545"
                ]
            },
            {
                "name": 30898,
                "op": 2,
                "values": [
                    110101,
                    "北京市/北京市/东城区"
                ]
            },
            {
                "name": 30751,
                "op": 2,
                "values": [
                    "09-01",
                    "09-02",
                    "09-03",
                    "09-04"
                ]
            },
            {
                "name": 31892,
                "op": 2,
                "values": [
                    "单行文本"
                ]
            },
            {
                "name": 31457,
                "op": 3,
                "values": [
                    1
                ]
            },
            {
                "name": 31270,
                "op": 2,
                "values": [
                    4,
                    5,
                    6
                ]
            },
            {
                "name": 32477,
                "op": 0,
                "values": [
                    0,
                    1
                ]
            },
            {
                "name": 31562,
                "op": null,
                "values": [
                    "2022-11-19",
                    "2022-12-19"
                ]
            },
            {
                "name": 31460,
                "op": null,
                "values": [
                    "2022-09-20 14:36:31",
                    "2022-12-19 14:36:31"
                ]
            },
            {
                "name": 31462,
                "op": 2,
                "values": [
                    "2.2"
                ]
            },
            {
                "name": "point_credit",
                "op": 7,
                "values": [
                    "112"
                ]
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/v3/customer/search' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerId": 513799527504064,
    "searchKey": "测试",
    "role": 1
    "departmentIdList": [
        966461,
        558613
    ],
    "salesIdList": [
        5885555666,
        666666584111
    ],
    "createTime": {
        "start": "2022-12-1300:00:00",
        "end": "2022-12-19 23:59:59"
    },
    "qwCustomerTime": {
        "start": null,
        "end": null
    },
    "qwLastFollowTypes": {
        "start": null,
        "end": null
    },
    "pageNo": 1,
    "pageSize": 100,
    "conditions": {
        "conditionOp": 1,
        "conditionItems": [
            {
                "name": "contentTagIds",
                "op": 6,
                "values": [
                    "d430ec9166e511edb71d00163e06cc86:2l"
                ]
            },
            {
                "name": "tagIds",
                "op": 6,
                "values": [
                    2801078
                ]
            },
            {
                "name": "point_credit",
                "op": 7,
                "values": [
                    "11"
                ]
            },
            {
                "name": "sales_stage",
                "op": 2,
                "values": [
                    474555082656000
                ]
            },
            {
                "name": 30744,
                "op": 2,
                "values": [
                    "15135859545"
                ]
            },
            {
                "name": 30898,
                "op": 2,
                "values": [
                    110101,
                    "北京市/北京市/东城区"
                ]
            },
            {
                "name": 30751,
                "op": 2,
                "values": [
                    "09-01",
                    "09-02",
                    "09-03",
                    "09-04"
                ]
            },
            {
                "name": 31892,
                "op": 2,
                "values": [
                    "单行文本"
                ]
            },
            {
                "name": 31457,
                "op": 3,
                "values": [
                    1
                ]
            },
            {
                "name": 31270,
                "op": 2,
                "values": [
                    4,
                    5,
                    6
                ]
            },
            {
                "name": 32477,
                "op": 0,
                "values": [
                    0,
                    1
                ]
            },
            {
                "name": 31562,
                "op": null,
                "values": [
                    "2022-11-19",
                    "2022-12-19"
                ]
            },
            {
                "name": 31460,
                "op": null,
                "values": [
                    "2022-09-20 14:36:31",
                    "2022-12-19 14:36:31"
                ]
            },
            {
                "name": 31462,
                "op": 2,
                "values": [
                    "2.2"
                ]
            },
            {
                "name": "point_credit",
                "op": 7,
                "values": [
                    "112"
                ]
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

object

必需

totalCount

integer

总数量

必需

totalPage

integer

总页数

必需

pageNo

integer

当前页码

必需

pageSize

integer

页码大小

必需

data

array [object {97}]

必需

signId

number | null

必需

示例

{"code":0,"message":"success","data":{"totalCount":1,"totalPage":1,"pageNo":1,"pageSize":30,"limit":null,"limitType":null,"data":[{"toOpenSeaName":null,"customerAllocateSource":3,"getCreateTime":"2022-12-21 11:50:28","salesStageEndName":null,"recoveryReasons":[],"remainingProtectionTime":null,"followRepeat":false,"pvTagId":null,"isFailReason":false,"customerAbandonReason":null,"customerType":1,"toSalesName":null,"openSeaTransferRecordId":null,"customerSalesInfoId":515180602083520,"salesStage":480693588891904,"30747":"测试客户阶段0001","replyChatCount":0,"shareFirst":null,"id":515180602083520,"remainingProtectionReason":null,"salesStageSub":null,"contentType":null,"areaValue":"","30744":[],"salesStageName":"新入库","rollOutType":null,"wechatAvatar":null,"unionId":null,"lastFollowUserName":null,"groupList":[],"pointScore":null,"toSalesDeptNames":"[]","helperSalesName":"","tags":null,"getUpdateTime":"2022-12-21 11:50:34","companyId":null,"sendChatCount":0,"friendType":null,"followTimeType":0,"salesName":"张磊","externalUserId":null,"customerRepoId":450617011013824,"openSeaEditable":true,"customerAbandon":null,"groupSize":0,"salesStageEnd":null,"lastRequestSent":null,"birthday":null,"toId":null,"shield":null,"role":"1","tagIds":null,"requestSent":false,"shareSource":453638473541824,"salesDeptNames":"[\"江鑫祥科技/洋洋洋部门电商的就是看到第三节课京东数科建东加竞赛课\"]","channelState":"","customerRecovery":"-1","customerStatus":0,"helperSalesDeptNames":"[]","protectedTime":0,"salesId":453638473541824,"enterSeaReason":"新建/导入","enterSeaType":4,"deleteStatus":null,"salesDeleted":false,"customerId":515180602015936,"isFriend":false,"protect":0,"qwRemark":"测试客户阶段0001","corpNameShort":null,"shareFollows":[],"mainFollows":[{"salesId":453638473541824,"salesName":"张磊","followDeptNames":"[\"江鑫祥科技/洋洋洋部门电商的就是看到第三节课京东数科建东加竞赛课\"]","isFriend":false,"salesAvatar":"http://wework.qpic.cn/bizmail/hJO6Tic8PhQcl9UzETs8pPAp04CF2VyterhN1uS7DwVZALY0gb1Qgcw/0"}],"abandonTime":null,"toType":null,"corpName":null,"qwSalesId":"ZhangLei","fromId":null,"30750":0,"isCustomer":1,"lastFollowUserId":null,"signNum":0,"phoneRepeat":false,"deleted":0,"areaId":null,"31560":"编号- 5993831","createTime":"2022-12-21 11:50:28","wechatNickname":null,"location":null,"salesStageSubName":null,"stageFlowId":511292156367040,"contentTags":[],"pointCredit":null}],"signId":null}}

修改于 2023-11-03 02:34:06

推送注册接口

查询没有群聊的客户