批量给用户打标签（Batch Tagging Users）

描述：批量给多个用户打不同的tag API

限制：

单次单人打标上限10个

每天调用次数上限20万/次，每10秒调用次数上限 500次

若通过标签名打标，标签需要在Jing平台存在

Description: Batching different tag API to multiple users

Limit:

The maximum tags of single person is 10 per time

The maximum of calls per day is 200,000 times, and the maximum number of calls per 10 seconds is 500

For tagging by tag name, the tag needs to exist in the Jing platform

请求参数

Header 参数

app_id

string

应用id

必需

默认值:

access_token

string

应用密钥

必需

默认值:

Body 参数application/json

array of:

identity

object

必需

type

string

必需

必传，身份字段类型，可传wechat_unionid, wechat_openid, mobile, email, thirdparty_channel

（English）Required, identity field type, can assign wechat_unionid, wechat_openid, mobile, email, thirdparty_channel

value

string

必需

必传，身份字段类型对应的值

（English）Required. The value corresponding to the identity field type

channel_uuid

string

可选

非必传，渠道id，如果是第三方必填，为第三方渠道jing uuid

（English）Not required, channel id, if it is required by a third party, it is a third party channel jing uuid

tag_names

array[string]

必需

必传，标签名称数组，tag name或者 tag id必须有其一

（English）Required, tag name array,tag name or tag id must have one of them

tags

array[integer]

必需

必传，标签id数组，tag name或者 tag id必须有其一

（English）Required, the tag id array,tag name or tag id must have one of them

示例

[
    {
        "identity": {
            "type": "wechat_openid",
            "value": "oTyBt1lXlB9SllUt_pgThGZXQhS0"
        },
        "tags": [
            166044
        ]
    }
]

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

request_id

string

必需

code

string

必需

msg

string

必需

data

object

必需

success

array [object {1}]

必需

failure

array[string]

必需

示例

{
    "request_id": "30a41b5f3c9544c0b697f0c0416c99f2",
    "code": "10000",
    "msg": "success",
    "data": {
        "success": [
            {
                "wPxUsBX4kb5Dm2mkzCrrH7": "166044"
            }
        ],
        "failure": []
    }
}

🟢200失败