按企微客户id列出客户企业标签（批量）

请求参数

Header 参数

appId

string

应用 appId

必需

默认值:

timestamp

string

请求时间戳

必需

默认值:

sign

string

请求消息签名值

必需

默认值:

appKey

string

应用 appKey

可选

默认值:

Body 参数application/json

externalUserIds

array[string]

客户企微id

必需

为保证服务质量，一次查询客户数限制为100个

示例

{
    "externalUserIds": [
        "wmPBvlDQAAAtqjxUNvuEL5CRio1NWNXA"
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/v2/customer/qw-list-tags' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "externalUserIds": [
        "wmPBvlDQAAAtqjxUNvuEL5CRio1NWNXA"
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

业务状态码

必需

成功状态为0。参见响应业务状态码表

message

string

业务状态说明。

必需

data

array [object {2}]

客户标签列表

必需

externalUserId

string

客户企微id

可选

tags

array [object {3}]

客户的标签列表

可选

如果externalUserId对应客户不存在，tags为 null 而不是空列表

示例

{
    "code": 0,
    "message": "success",
    "data": [
        {
            "externalUserId": "wmPBvlDQAAAtqjxUNvuEL5CRio1NWNXA",
            "tags": [
                {
                    "qwTagId": "etPBvlDQAAOQjuC4-VHT0iGguski7YMQ",
                    "name": "阿斯达四方",
                    "qwUserId": "刘xx"
                },
                {
                    "qwTagId": "etPBvlDQAAWXXZVAk_LeuPCmjeP6Tkvw",
                    "name": "ad",
                    "qwUserId": "刘xx"
                },
                {
                    "qwTagId": "etPBvlDQAA29gh91nSPEW0nqm5L5z7PA",
                    "name": "阿斯蒂芬",
                    "qwUserId": "刘xx"
                },
                {
                    "qwTagId": "etPBvlDQAAnPgiWuQ32wOJBr6JgtUOTQ",
                    "name": "百度渠道",
                    "qwUserId": "刘xx"
                },
                {
                    "qwTagId": "etPBvlDQAANRlrqgrkXXJ7SCGnxpWJWA",
                    "name": "百度渠道",
                    "qwUserId": "孙xx"
                }
            ]
        }
    ]
}

🟢200异常