MobPush 推送查询 API

设备详情接口

接口地址：http://api.push.mob.com/device-v3/getById/+registrationId

接口示例：http://api.push.mob.com/device-v3/getById/65ou4rojokauxog

请求方式：GET

接口访问频率限制：受限，参照接口频率限制

请求头部

请求参数：无

返回参数说明

根据别名查询设备信息

接口地址：http://api.push.mob.com/device-v3/getByAlias/+alias

接口示例：http://api.push.mob.com/device-v3/getByAlias/554804

请求方式：GET

接口访问频率限制：受限，参照接口频率限制

请求头部

请求参数：无

返回参数说明

根据标签查看查询设备信息

接口地址：http://api.push.mob.com/device-v3/queryByTags

请求方式：POST

返回说明：目前只返回 1000 条设备相关信息

接口访问频率限制：受限，参照接口频率限制

请求头部

请求参数：

返回参数说明

设备分布接口(用于查询设备的推送是否打开或者卸载的分布情况)

接口地址：http://api.push.mob.com/device-v3/distribution

请求方式：GET

接口访问频率限制：受限，参照接口频率限制

请求头部：

请求参数：无

返回参数说明

新增标签 删除标签 清空标签

接口地址： http://api.push.mob.com/device-v3/updateTags

请求方式：POST

接口访问频率限制：受限，参照接口频率限制

请求头部

请求参数：

返回参数：

设置别名

接口地址：http://api.push.mob.com/device-v3/updateAlias

请求方式：POST

接口访问频率限制：受限，参照接口频率限制

请求头部

请求参数：

返回参数：

推送任务状态（根据 workId 查询 workId 为推送任务 ID）

接口地址：http://api.push.mob.com/v3/push/getWorkStatus

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

请求示例

{"appkey":"2e08782eb311b","workId":"4bp4tw9tzd1rwcczr4"}

返回参数说明

推送详情（根据 workId 查询 workId 为推送任务 ID）

接口地址：http://api.push.mob.com/v3/stats/getByWorkId

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

请求示例

{"workId":"32ugyk7bqlm8we8","appkey":"2ecbc7bc53712"}

返回参数说明

推送详情（根据 workId 数组查询 workId 为推送任务 ID）

接口地址：http://api.push.mob.com/v3/stats/getByWorkIds

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

请求示例

{"workIds":["32ugyk7bqlm8we8","32ugykg7590v56o"],"appkey":"2ecbc7bc53712"}

返回参数说明

推送详情（根据 workno 查询 workno 为自定义任务 ID，只能查询最近 3 天的数据）

接口地址： http://api.push.mob.com/v3/stats/getByWorkno

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

返回参数请参考 3.1 根据任务 id 查询的返回参数说明

推送详情（按小时查询）

接口地址： http://api.push.mob.com/v3/stats/getByHour

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

请求示例

{"hour":"2020082415","appkey":"2ecbc7bc53712"}

返回参数说明

推送详情（按日期查询）

接口地址： http://api.push.mob.com/v3/stats/getByDay

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

请求示例

{"day":"20200824","appkey":"2ecbc7bc53712"}

返回参数请参考 3.4 根据小时查询的返回参数说明

推送详情（查询每次下发的设备信息）

注：该接口暂只支持查精准推送的推送设备详情（例如：别名、rid、别名文件推送和 rid 文件推送）

接口地址： http://api.push.mob.com/v3/stats/getByDevice

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

请求示例

{"appkey":"2ecbc7bc53712","workId":"32ugyk7bqlm8we8","pageIndex":1,"pageSize":20}

返回参数说明

根据活动任务 id 查询活动任务聚合数据

接口地址:http://api.push.mob.com/v3/stats/getActivity

请求方式：POST

请求头部

请求参数

请求示例

// 活动任务id为用户自行设置，且唯一{"appkey":"2ecbc7bc53712","activityWorkId ":"09876213123131"}

返回参数说明

其他接口

校验 scheme 长度是否超过厂商限制

接口地址：http://api.push.mob.com/push/valid/schemeLength

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

请求示例

{"scheme":"mlink://com.mob.mobpush.link","schemeDataList":[{"key":"key","value":"value"}]}

返回参数说明

FileId 上传文件

注：上传的 File 保存时间一个月，一次最多可上传 100 万 rid/别名

接口地址：http://api.push.mob.com/v3/push/uploadData

请求方式：POST

接口访问频率限制：受限，参照 接口频率限制

请求头部

请求参数

请求示例

{"appkey":"3159a7cd8d12f","type":1,"uploadData":["65kzjroi4idsi68","65kzmcrgi2kz85c"]}

返回参数说明