获取对象和对象标签（对象ID必传）

请求参数

Query 参数

access_token

string

必需

示例值:

Body 参数multipart/form-data

object

string

必需

对象类型， leads_schema_data=市场线索对象，member=会员对象，user_wx_relation=粉丝对象，externalDataSource=外部数据源，mochatLink=企微外部联系人。。

customer_ids

string

必需

对象唯一标识，支持多个用,隔开【不同对象可通过对象基础信息接口获取】
1丶object=leads_schema_data时，此值输入线索的customer_id【可通过接口{线索->获取线索列表接口中的data.list.customer_id中取值}】。
2丶object=member时，此值输入会员的member_id【可通过接口{会员-获取基础信息接口中的data.id中取值}】。
3丶object=user_wx_relation时，此值输入粉丝的openid即可。
4丶当object=mochatLink企微外部联系人时，需指定数据源信息进行打标签（此值为外部联系人的唯一标识，通过获取客群列表数据-V2【返回的数组中data.list.identity_id字段获得】）

nextId

string

可选

1丶当object=user_wx_relation粉丝对象时，需指定公众号信息进行打标签（此值为公众号唯一标识，从接口【应用中心->公众号管理->获取微信公众号列表接口的data.wx_id字段获得】）。
2丶当object=externalDataSource外部数据源时，需指定数据源信息进行打标签（此值为外部数据源表结构唯一标识，从接口【客群->获取客群列表接口->返回的数组中data.id字段获得】）
3丶当object=mochatLink企微外部联系人时，需指定数据源信息进行打标签（此值为外部数据源表结构唯一标识，通过获取客群对象列表，参数customersField=mochatLink获取，返回的数组中data.id字段获得）

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request POST 'https://openapi.beschannels.com/tags/open-api/object-get-tag?access_token=uURA1lnYsBr22I6UYoLZH0s9y3HU2Xsn7UHA4dIDgHN_67Z5EZskh4YMcymD5enS4GGjWpOERwQtug3Y4AGwvbvLB_A3TwKBpb_J4z0MUm6oaNQmqA-3Ef9Q-PHbVPk3' \
--form 'object=""' \
--form 'customer_ids=""' \
--form 'nextId=""'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

123456-2002

array [object {3}]

对象id

必需

123456-2001

array [object {3}]

对象id

必需

示例

市场线索会员成功示例粉丝列表

{
    "code": 0,
    "msg": "成功",
    "data": {
        "f120d449-abf4-2327-da25-8a85becf9803": [
            {
                "id_string": "f01386d7c250a27d",
                "name": "tag-2023年8月14日-3",
                "create_time": "2023-08-14 10:30:48"
            },
            {
                "id_string": "84092136535fb25e",
                "name": "tag-2023年8月14日-4",
                "create_time": "2023-08-14 10:30:44"
            },
            {
                "id_string": "1d5b65933691e4c4",
                "name": "tag-2023年8月14日-5",
                "create_time": "2023-08-14 10:30:41"
            },
            {
                "id_string": "400d50797f22cc6c",
                "name": "微信模板消息可触达",
                "create_time": "2023-06-13 00:43:33"
            },
            {
                "id_string": "92e65251a13e1bcf",
                "name": "手机短信",
                "create_time": "2023-06-10 01:41:26"
            }
        ]
    }
}