数据查询
更新时间:2021-11-29
查询用户状态
功能说明
查询设备在线状态
接口说明
请求地址:https://push.safe.baidu.com/push/api/open/v1/device/status
请求方法:POST
请求
请求示例
curl -X POST \
'http://push.safe.baidu.com/push/api/open/v1/device/status?appkey=10001&sign=a4196376da5f792394a0510431cb6dd5×tamp=1543314608' \
-H 'Content-Type: application/json' \
-d '{
"push_ids":["push_id1","push_id2"]
}'
响应
响应示例
{
"request_id": 1148935963,
"code": 0,
"result": {
"push_id1": {
"status": "offline",
"last_online_time": 1543893955,
},
"push_id2": {
"status": "invalid"
}
}
}
参数说明
参数 | 类型 | 说明 |
---|---|---|
request_id | int64 | 用于异常排查 |
code | int | 错误码 |
message | string | 错误说明 |
result | json object | 设备状态信息,key为设备id |
result内包含以下字段 | ||
status | string | 设备状态,可枚举值如下:“invalid”:设备无效,该id可能未注册。“online”:在线。“offline”:离线 |
last_online_time | int | 秒级别时间戳,最后在线时间 |
错误码请参考全局错误码
查询送达状态
功能说明
查询特定推送消息是否已送达到一组设备
接口说明
请求地址:https://push.safe.baidu.com/push/api/open/v1/message/status
请求方法:POST
请求
请求示例
curl -X POST \
'http:// push.safe.baidu.com/push/api/open/v1/message/status?appkey=10001&sign=a4196376da5f792394a0510431cb6dd5×tamp=1543314608' \
-H 'Content-Type: application/json' \
-d '{
"push_ids":["push_id1","push_id2","push_id3"],
"msg_id":"1003"
}'
参数说明
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
msg_id | 是 | string | 消息id |
push_ids | 是 | string array | 设备id列表 |
响应
响应示例
{
"request_id": 730433995,
"code": 0,
"result": {
"push_id1": {
"status": 0
},
"push_id2": {
"status": 1
},
"push_id3": {
"status": 2
}
}
}
参数说明
参数 | 类型 | 说明 |
---|---|---|
request_id | int64 | 用于异常排查 |
code | int | 错误码 |
message | string | 错误说明 |
result | json object | 消息到达状态,key为设备id |
result内包含以下字段 | ||
status | int | 消息送达状态,可枚举值如下:0:已接收;1:未接收;2:设备id无效 |
错误码请参考全局错误码
获取具体消息推送数据
功能说明
查询消息有效可下发总数,用户点击数等结果
接口说明
请求地址:https://push.safe.baidu.com/push/api/open/v1/message/result
请求方法:POST
请求
请求示例
curl -X POST \ 'http:// push.safe.baidu.com/push/api/open/v1/message/result?appkey=1&sign=a4196376da5f792394a0510431cb6dd5×tamp=1543314608' \
-H 'Content-Type: application/json' \
-d '{
"msg_ids":["1"]
}'
参数说明
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
msg_ids | 是 | string array | 消息id列表 |
响应
响应示例
{
"request_id": 1511178925,
"code": 0,
"result": [
{
"msg_id": "1",
"publish": 92967,
"arrive": 85436,
"display": 45279,
"click": 9165,
"push": {
"publish": 63276,
"arrive": 62449,
"display": 23108,
"click": 8985
}
}
]
}
参数说明
参数 | 类型 | 说明 |
---|---|---|
request_id | int64 | 用于异常排查 |
code | int | 错误码 |
message | string | 错误说明 |
result | json object | 统计信息 |
result 内包含以下字段 | ||
msg_id | string | 消息id |
publish | int | 总下发数 |
arrive | int | 总到达数 |
display | int | 总展示数 |
click | int | 总点击数 |
push | json object | 使用慧推长连接下发的消息统计信息 |
错误码请参考全局错误码
获取单日推送数据接口
功能说明
获取应用具体某天的推送数据
接口说明
请求地址:https://push.safe.baidu.com/push/api/open/v1/app/daily/result
请求方法:POST
请求
请求示例
curl -X POST \
'http://push.safe.baidu.com/push/api/open/v1/app/daily/result?appkey=1&sign=a4196376da5f792394a0510431cb6dd5×tamp=1543314608' \
-H 'Content-Type: application/json' \
-d '{
"date":"2018-11-03"
}'
参数说明
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
date | 是 | int64 | 日期格式 YYYY-MM-DD |
响应
响应示例
{
"request_id": 1320584980,
"code": 0,
"result": {
"publish": 25580,
"arrive": 25176,
"display": 8247,
"click": 3550
}
}
参数说明
参数 | 类型 | 说明 |
---|---|---|
request_id | int64 | 用于异常排查 |
code | int | 错误码 |
message | string | 错误说明 |
result | json object | 统计信息 |
result 内包含以下字段 | ||
publish | int | 总下发数 |
arrive | int | 总到达数 |
display | int | 总展示数 |
click | int | 总点击数 |
错误码请参考全局错误码
定时任务查询接口
功能说明
查询定时任务的广播消息的发送状态
接口说明
请求地址:https://push.safe.baidu.com/push/api/open/v1/message/schedule
请求方法:POST
请求
请求示例
curl -X POST \
'http://127.0.0.1:8760/push/api/open/v1/message/schedule?appkey=700000126' \
-H 'Content-Type: application/json' \
-d '{
"msg_id":"1013"
}'
参数说明
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
msg_id | 是 | string | 消息id |
响应
响应示例
{
"request_id": 1216697925,
"code": 0,
"result": {
"status": 0,
"msg_id": "1013",
"create_time": 1544689046,
"push_time": 1544716800
}
}
参数说明
参数 | 类型 | 说明 |
---|---|---|
request_id | int64 | 用于异常排查 |
code | int | 错误码 |
message | string | 错误说明 |
result | json object | 定时任务消息状态 |
result 内包含以下字段 | ||
status | int | 消息下发状态,可枚举值如下:0 :消息已保存,等待下发;1:已经下发 |
msg_id | int | 消息id |
create_time | int | 消息创建时间 |
push_time | int | 定时推送时间 |
错误码请参考全局错误码