# 查询批量消息推送和阅读人数
注意事项:
- 返回值为查询时刻的快照数据
- 只能查询批量发送的消息
# 请求
| 基本 | |
|---|---|
| HTTP URL | https://hi-qa.weizhipin.com/open-apis/im/v2/batch_messages/:batch_message_id/read_user |
| HTTP Method | GET |
| 支持的应用类型 | 自建应用 商店应用 |
| 权限要求开启任一权限即可 | 批量向用户发送消息 批量向部门发送消息 |
# 请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token"示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" |
# 路径参数(url中冒号标识的参数,如":xxxx"请连同:整体替换成对应值)
| 名称 | 类型 | 描述 |
|---|---|---|
| batch_message_id | string | 待查询的批量消息的ID 示例值:"bm_dc13264520392913993dd051dba21dcf" |
# 响应
# 响应体
| 名称 | 类型 | 描述 |
|---|---|---|
| code | int | 错误码,非 0 表示失败 |
| msg | string | 错误描述 |
| data | - | - |
| ∟read_user_ids | string[] | 已读用户Id 字段权限要求: 获取用户 user_id(仅自建应用) |
| ∟un_read_user_ids | string[] | 未读用户Id 字段权限要求: 获取用户 user_id(仅自建应用) |
| ∟read_open_ids | string[] | 已读open_i️id |
| ∟un_read_open_ids | string[] | 未读open_id |
# 响应体示例
{
"code": 0,
"traceId": "_Ao59UOIBLPCeAAu",
"data": {
"read_user_ids": ["xxxx","xxxx"],
"un_read_user_ids": ["xxxx","xxxx"]
},
"msg": "ok"
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9