即时通信 IM 获取用户标签 - 服务端 API

功能说明

获取用户标签（必须以管理员帐号调用）。每次最多只能获取100个用户的标签。

接口调用说明

本功能仅针对旗舰版客户开放申请（如您降级为专业版将无法使用），您可通过 工单 申请开通该功能，申请后我们将对您的需求进行评估，需求评估合理后您方可使用该功能。

请求 URL 示例

https://console.tim.qq.com/v4/all_member_push/im_get_tag?usersig=xxx&identifier=admin&sdkappid=88888888&random=99999999&contenttype=json

请求参数说明

最高调用频率

100次/秒。

请求包示例

{
    "To_Account": [
        "xiaojun012",
        "xiaojun013"
    ]
}

请求包字段说明

应答包体示例

{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0,
    "UserTags": [
        {
            "To_Account": "xiaojun012",
            "Tags": ["a", "b"]
        },
        {
            "To_Account": "xiaojun013",
            "Tags": ["a", "c"]
        }
    ]
}

应答包字段说明

错误码说明

除非发生网络错误（例如502错误），否则该接口的 HTTP 返回码均为200。真正的错误码，错误信息是通过应答包体中的 ErrorCode、ErrorInfo 来表示的。公共错误码（60000到79999）参见 错误码 文档。
本 API 私有错误码如下：

接口调试工具

通过 REST API 在线调试 工具调试本接口。

参考

• 全员推送接口说明
• 全员推送
• 设置应用属性名称
• 获取应用属性名称
• 设置用户属性
• 删除用户属性
• 获取用户属性
• 添加用户标签
• 删除用户标签
• 删除用户所有标签