搜索客户列表

POST

/open-api/customer/wecom/customer/get

最后修改时间：2025-03-10 10:07:16

查询符合所有请求条件的客户列表。

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{auth_token}}

Body 参数application/json

开放中心 - 客户资料 Req VO

customerIds

array[integer <int64>]

可选

>= 0 items<= 2000 items

unionids

array[string]

可选

>= 0 items<= 2000 items

externalUserIds

array[string]

可选

>= 0 items<= 2000 items

mobiles

array[string]

可选

>= 0 items<= 2000 items

示例

{
    "customerIds": [
        0
    ],
    "unionids": [
        "string"
    ],
    "externalUserIds": [
        "string"
    ],
    "mobiles": [
        "string"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/open-api/customer/wecom/customer/get' \
--header 'Authorization: Bearer {{auth_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customerIds": [
        0
    ],
    "unionids": [
        "string"
    ],
    "externalUserIds": [
        "string"
    ],
    "mobiles": [
        "string"
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer <int32>

可选

data

array[object (OpenCustomerSimpleInfoRespVO) {8}]

可选

integer <int64>

客户ID

可选

externalUserId

string

客户企微id

可选

unionid

string

unionid

可选

nickName

string

微信昵称

可选

avatar

string

头像

可选

name

string

姓名

可选

mobile

array[string]

手机号

可选

createTime

string <date-time>

创建时间

可选

msg

string

可选

requestId

string

可选

示例

{
    "code": 0,
    "data": [
        {
            "id": 0,
            "externalUserId": "string",
            "unionid": "string",
            "nickName": "string",
            "avatar": "string",
            "name": "string",
            "mobile": [
                "string"
            ],
            "createTime": "2019-08-24T14:15:22Z"
        }
    ],
    "msg": "string",
    "requestId": "string"
}

开发中心-客户业务线归属

更新同步客户信息