MobPush 推送查询API
admin
2024-03-01 11:02:48
0次
设备详情接口
接口地址：http://api.push.mob.com/device-v3/getById/+registrationId
接口示例：http://api.push.mob.com/device-v3/getById/65ou4rojokauxog
请求方式：GET
接口访问频率限制：受限，参照接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | Mob后台的MobAppSecret md5(由于不需要参数所以直接对Secret进行md5) |
请求参数：无
返回参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| registrationId | String | rid 用户客户端获取的registrationId |
| tags | String[] | 设备标签数组 |
| alias | String | 设备别名 |
| mobile | String | 手机号码（ 用于短信补量等功能） |
| openPush | number | 是否开启推送 1：开启，0：关闭 |
| status | number | 设备状态 1:正常，3：卸载，0：删除（卸载统计未开通） |
根据别名查询设备信息
接口地址：http://api.push.mob.com/device-v3/getByAlias/+alias
接口示例：http://api.push.mob.com/device-v3/getByAlias/554804
请求方式：GET
接口访问频率限制：受限，参照接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | Mob后台的MobAppSecret md5(由于不需要参数所以直接对Secret进行md5) |
请求参数：无
返回参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| registrationId | String | rid 用户客户端获取的registrationId |
| tags | String[] | 设备标签数组 |
| alias | String | 设备别名 |
| mobile | String | 手机号码（ 用于短信补量等功能） |
| openPush | number | 是否开启推送 1：开启，0：关闭 |
| status | number | 设备状态 1:正常，3：卸载，0：删除（卸载统计未开通） |
根据标签查看查询设备信息
接口地址：http://api.push.mob.com/device-v3/queryByTags
请求方式：POST
返回说明：目前只返回1000条设备相关信息
接口访问频率限制：受限，参照接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数：
| 参数名 | 参数类型 | 是否必要参数 | 参数说明 |
|---|---|---|---|
| appkey | String | 否 | Mob后台的MobAppKey |
| tags | String[] | 否 | 标签数组，交集查询，需要与rid下的tags全部匹配 |
返回参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| registrationId | String | rid 用户客户端获取的registrationId |
| tags | String[] | 设备标签数组 |
| alias | String | 设备别名 |
| mobile | String | 手机号码（ 用于短信补量等功能） |
| openPush | number | 是否开启推送 1：开启，0：关闭 |
| status | number | 设备状态 1:正常，3：卸载，0：删除（卸载统计未开通） |
设备分布接口(用于查询设备的推送是否打开或者卸载的分布情况)
接口地址：http://api.push.mob.com/device-v3/distribution
请求方式：GET
接口访问频率限制：受限，参照接口频率限制
请求头部：
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| key | String | Mob后台的MobAppKey |
| sign | String | Mob后台的MobAppSecret md5(由于不需要参数所以直接对Secret进行md5) |
请求参数：无
返回参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| openPush | number | 打开推送权限设备数量 |
| closePush | number | 关闭推送权限设备数量 |
| uninstall | number | 卸载设备数量（功能未开通） |
新增标签 删除标签 清空标签
接口地址： http://api.push.mob.com/device-v3/updateTags
请求方式：POST
接口访问频率限制：受限，参照接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数：
| 参数名 | 参数类型 | 是否必要参数 | 参数说明 |
|---|---|---|---|
| appkey | String | 是 | Mob后台的MobAppKey |
| registrationId | String | 是 | 用户客户端口获取的registrationId |
| opType | number | 否 | 操作类型：1新增标签；2删除标签；3清空标签 |
| tags | String[] | 否 | 标签数组（opType类型为3时候不用传入） |
返回参数：
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| status | number | satus=200 成功 |
| res | object | 暂时返回为null |
| error | String | 返回error |
设置别名
接口地址：http://api.push.mob.com/device-v3/updateAlias
请求方式：POST
接口访问频率限制：受限，参照接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数：
| 参数名 | 参数类型 | 是否必要参数 | 参数说明 |
|---|---|---|---|
| appkey | String | 否 | Mob后台的MobAppKey |
| registrationId | String | 是 | 用户客户端口获取的registrationId |
| alias | String | 否 | 需要设置的别名 |
返回参数：
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| status | number | satus=200 成功 |
| res | object | 暂时返回null |
| error | String | 返回error |
推送任务状态（根据workId查询 workId为推送任务ID）
接口地址：http://api.push.mob.com/v3/push/getWorkStatus
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| workId | String | 推送任务的唯一任务id |
请求示例
{"appkey":"2e08782eb311b","workId":"4bp4tw9tzd1rwcczr4"}返回参数说明
| 参数名 | 参数类型 | 说明 |
|---|---|---|
| status | number | 状态码 |
| res | string | 任务状态：”发送完成“、“取消成功”、“创建中”、“等待发送”、“发送中”、“发送完成”、“发送失败”、“停止发送”、“已取消”、 “取消成功”、“已撤回”、“下发失败” |
| error | string | 报错信息(正常情况值为null) |
推送详情（根据workId查询 workId为推送任务ID）
接口地址：http://api.push.mob.com/v3/stats/getByWorkId
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| workId | String | 推送任务的唯一任务id |
请求示例
{"workId":"32ugyk7bqlm8we8","appkey":"2ecbc7bc53712"}返回参数说明
| 参数名 | 参数类型 | 说明 | |
|---|---|---|---|
| status | Int | 状态码 | |
| ios | object | iOS的统计可以参考下面展开参数 | |
| fetchNum | int | 返回的设备数量 | |
| deliverNum | int | 实际下发的设备数量 | |
| deliverFailNum | int | 下发失败的数量 | |
| reportNum | int | 下发后回执的数量 （iOS回执不准确或者为0仅供参考） | |
| reportFailNum | int | 下发后回执失败的数量 | |
| clickNum | int | 点击通知的数量 | |
| android | object | 安卓的统计可以参考上面iOS展开参数 | |
| factory | object | 通过厂商和APNS下发的统计 参考同上 | |
| mobpush | object | 通过MobPush通道下发的统计 参考同上 | |
| iostcp | object | 通过MobPush通道下发iOS的统计 参考同上 | |
| androidtcp | object | 通过MobPush通道下发Android的统计 参考同上 | |
| apns | object | 通过APNS下发的统计 参考同上 | |
| huawei | object | 通过华为厂商下发的统计 参考同上 | |
| xiaomi | object | 通过小米厂商下发的统计 参考同上 | |
| flyme | object | 通过魅族厂商下发的统计 参考同上 | |
| fcm | object | 通过谷歌厂商下发的统计 参考同上 | |
| oppo | object | 通过oppo厂商下发的统计 参考同上 | |
| vivo | object | 通过vivo厂商下发的统计 参考同上 | |
| sms | object | 短信补量下发统计 | |
| offlineIos | object | iOS离线统计 | |
| offlineAndroid | object | 安卓离线统计 |
推送详情（根据workId数组查询 workId为推送任务ID）
接口地址：http://api.push.mob.com/v3/stats/getByWorkIds
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| workIds | String[] | 推送任务id的数组 |
请求示例
{"workIds":["32ugyk7bqlm8we8","32ugykg7590v56o"],"appkey":"2ecbc7bc53712"}返回参数说明
| 参数名 | 参数类型 | 说明 | |
|---|---|---|---|
| status | Int | 状态码 | |
| ios | object | iOS的统计可以参考下面展开参数 | |
| fetchNum | int | 返回的设备数量 | |
| deliverNum | int | 实际下发的设备数量 | |
| deliverFailNum | int | 下发失败的数量 | |
| reportNum | int | 下发后回执的数量 （iOS回执不准确或者为0仅供参考） | |
| reportFailNum | int | 下发后回执失败的数量 | |
| clickNum | int | 点击通知的数量 | |
| android | object | 安卓的统计可以参考上面iOS展开参数 | |
| factory | object | 通过厂商和APNS下发的统计 参考同上 | |
| mobpush | object | 通过MobPush通道下发的统计 参考同上 | |
| iostcp | object | 通过MobPush通道下发iOS的统计 参考同上 | |
| androidtcp | object | 通过MobPush通道下发Android的统计 参考同上 | |
| apns | object | 通过APNS下发的统计 参考同上 | |
| huawei | object | 通过华为厂商下发的统计 参考同上 | |
| xiaomi | object | 通过小米厂商下发的统计 参考同上 | |
| flyme | object | 通过魅族厂商下发的统计 参考同上 | |
| fcm | object | 通过谷歌厂商下发的统计 参考同上 | |
| oppo | object | 通过oppo厂商下发的统计 参考同上 | |
| vivo | object | 通过vivo厂商下发的统计 参考同上 | |
| sms | object | 短信补量下发统计 | |
| offlineIos | object | iOS离线统计 | |
| offlineAndroid | object | 安卓离线统计 |
推送详情（根据workno查询 workno为自定义任务ID，只能查询最近3天的数据）
接口地址： http://api.push.mob.com/v3/stats/getByWorkno
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| workno | String | 用户的推送任务id |
返回参数请参考3.1根据任务id查询的返回参数说明
推送详情（按小时查询）
接口地址： http://api.push.mob.com/v3/stats/getByHour
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| hour | String | 时间精确到小时yyyyMMddHH 例如2020082415 查询2020年08月24日 15点钟的所有推送 |
请求示例
{"hour":"2020082415","appkey":"2ecbc7bc53712"}返回参数说明
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| fetchNum | number | 总设备数 |
| fetchNumAndroid | number | 安卓的设备数量 |
| fetchNumIos | number | iOS的推送设备数量 |
| workNum | number | 推送任务熟练 |
| workNumAndroid | number | 推送给安卓的任务数量 |
| workNumIos | number | 推送给iOS的任务数量 |
| deliverNumTcp | number | 通过TCP通道（MobTech的通道）下发的数量 |
| reportNumTcp | number | TCP回调的数量 |
| clickNumTcp | number | TCP通道点击通知的数量 |
| deliverNum | number | 消息下发总数量 |
| deliverNumAndroid | number | 安卓消息下发数量 |
| deliverNumIos | number | iOS消息下发数量 |
| reportNum | number | 推送回执数量 |
| reportNumAndroid | number | 安卓推送回执数量 |
| reportNumIos | number | iOS推送回执数量（iOS 下发回执不准确仅供参考也可能为0） |
| clickNum | number | 推送点击数量 |
| clickNumAndroid | number | 安卓推送点击数量 |
| clickNumIos | number | iOS推送点击数量 |
| apiNum | number | api调用次数 |
| apiNumAndroid | number | 安卓api调用次数 |
| apiNumIos | number | iOSapi调用次数 |
| activeNum | number | 设备活跃数量 |
| activeNumAndroid | number | 安卓设备活跃量 |
| activeNumIos | number | iOS设备活跃数量 |
| newDeviceNum | number | 新增设备数量 |
| newDeviceNumAndroid | number | 新增安卓设备数量 |
| newDeviceNumIos | number | 新增iOS设备数量 |
| onlineTimeAvg | number | 设备平均在线时长 |
| onlineTimeAvgAndroid | number | 安卓设备平均在线时长 |
| onlineTimeAvgIos | number | iOS设备平均在线时长 |
| onlineTimeAll | number | 设备在线总时长（优化中） |
| onlineTimeAllAndroid | number | 安卓设备在线总时长（优化中） |
| onlineTimeAllIos | number | iOS设备在线总时长（优化中） |
| openAppAvg | number | app平均打开次数（即启动应用次数） |
| openAppAvgIos | number | iOS app平均打开次数 |
| openAppAvgAndroid | number | 安卓app平均打开次数 |
| openAppAll | number | 设备打开app总次数 |
| openAppAllAndroid | number | 安卓app 打开总次数 |
| openAppAllIos | number | iOS app打开总次数次数 |
推送详情（按日期查询）
接口地址： http://api.push.mob.com/v3/stats/getByDay
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| day | String | 时间精确到小时yyyyMMdd 例如20200824 查询2020年08月24日 24号的所有推送 |
请求示例
{"day":"20200824","appkey":"2ecbc7bc53712"}返回参数请参考3.4根据小时查询的返回参数说明
推送详情（查询每次下发的设备信息）
注：该接口暂只支持查精准推送的推送设备详情（例如：别名、rid、别名文件推送和rid文件推送）
接口地址： http://api.push.mob.com/v3/stats/getByDevice
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| workId | String | 推送的任务id |
| pageIndex | number | 页码 |
| pageSize | number | 页面条数 |
请求示例
{"appkey":"2ecbc7bc53712","workId":"32ugyk7bqlm8we8","pageIndex":1,"pageSize":20}返回参数说明
| 参数名 | 参数类型 | 说明 | |
|---|---|---|---|
| totalPages | number | 返回总的页数 | |
| total | number | 返回设备的总数 | |
| content | object[] | 返回的下发设备信息数组 | |
| rid | String | 设备的绑定id 可以在客户端打印获取 | |
| workId | String | 任务id | |
| alias | String | 设备别名 | |
| tag | String | 标签 | |
| id | String | 设备id | |
| patchId | String | 推送批次id（暂时是MobTech内部自己使用的字段） | |
| deliver | String[] | 下发类型如["apns"] | |
| deliverTime | number | 下发次数 | |
| report | String[] | 下发回执类型 | |
| reportTime | number | 回执次数 | |
| click | String[] | 点击类型 | |
| clickTime | number | 点击次数 |
根据活动任务id查询活动任务聚合数据
接口地址:http://api.push.mob.com/v3/stats/getActivity
请求方式：POST
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | Mob后台的MobAppKey |
| activityWorkId | String | 推送的活动任务id |
请求示例
// 活动任务id为用户自行设置，且唯一
{"appkey":"2ecbc7bc53712","activityWorkId ":"09876213123131"}返回参数说明
| 参数名 | 参数类型 | 说明 | |
|---|---|---|---|
| status | number | 200 | |
| res | object[] | res | |
| appkey | string | Mob的appkey | |
| activityWorkId | string | 活动任务id | |
| fetchNum | number | 目标数 | |
| deliverNum | number | 下发数 | |
| reportNum | number | 到达数 | |
| clickNum | number | 点击数 | |
| error | null | error |
其他接口
校验scheme长度是否超过厂商限制
接口地址：http://api.push.mob.com/push/valid/schemeLength
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| scheme | String | scheme地址 |
| schemeDataList | object[] | scheme参数 |
| key | String | |
| value | String |
请求示例
{"scheme":"mlink://com.mob.mobpush.link","schemeDataList":[{"key":"key","value":"value"}]}返回参数说明
| 参数名 | 参数类型 | 说明 | |
|---|---|---|---|
| status | Int | 状态码 | |
| res | object [] | 返回值 | |
| channel | string | 厂商 | |
| maxLength | string | 厂商最大支持长度 | |
| currentLength | string | 当前长度 | |
| tooLong | boolean | 是否超长 | |
| error | string | 错误信息 |
FileId上传文件
注：上传的File保存时间一个月，一次最多可上传100万rid/别名
接口地址：http://api.push.mob.com/v3/push/uploadData
请求方式：POST
接口访问频率限制：受限，参照 接口频率限制
请求头部
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| Content-Type | application/json | 必要参数 |
| key | String | Mob后台的MobAppKey |
| sign | String | 请求参数+MobAppSecret md5 |
请求参数
| 参数名 | 参数类型 | 参数说明 |
|---|---|---|
| appkey | String | AppKey |
| type | number | 1rid；2alias |
| uploadData | string [] | 上传的rid或者别名 |
请求示例
{"appkey":"3159a7cd8d12f","type":1,"uploadData":["65kzjroi4idsi68","65kzmcrgi2kz85c"]}返回参数说明
| 参数名 | 参数类型 | 说明 | |
|---|---|---|---|
| status | Int | 状态码 | |
| res | string | fileId | |
| error | string | 错误信息 |
相关内容
热门资讯
CTI华测检测与丰宾电子落地全...
(全球TMT 2026年07月09日讯)6月26日，丰宾电子科技股份有限公司与华测检测认证集团股份有...
87家城商行上榜《2026年度...
7月8日，英国《银行家》杂志（The Banker）发布2026年度全球银行1000强榜单，该榜单以...
银行小程序“瘦身”潮起！流量红...
当遍地开花的银行小程序加速退场，一场以存量深耕、协同经营为核心的渠道重构正在银行业上演。7月9日，北...
微信小程序开发需要多久？从3天...
微信小程序开发需要多久？每个商家在启动项目前最关心的问题之一。时间就是成本，时间就是商机。在长沙云中...
商品老兵：现在是抄底黄金的最佳...
黄金价格较高点回调逾25%，但在大宗商品资深投资人看来，这场调整恰恰是难得的布局窗口。 近日，在Ri...
股价提前涨停！603986，上...
今日盘后，兆易创新(603986.SH)公告称，预计2026年半年度归属于上市公司股东的净利润为69...
担忧AI投资热潮！美联储，还是...
北京时间7月9日凌晨，美联储公布今年6月联邦公开市场委员会（FOMC）政策会议纪要。纪要显示，随着通...
1480亿，东莞草根女首富刚刚...
“要么不做，要做就做第一。” 来源：元素elements 作者：李冰之 编辑：吾人 刚刚，鼎泰高科成...
原创 一...
路过小区街边，总能看见不少经营多年的烟酒商行贴着转让告示。 前阵子楼下开了十多年的老店清仓甩货，成箱...
珞石赴港，“机器人们”等待上岸
盘中最高涨超17%，港股再迎来自机器人赛道的优质标的。 7月9日，覆盖工业机械臂、协作机器人、具身智...
日经225指数日内涨幅达1%
日经225指数日内涨幅达1%。
安全可信，算力赋能智慧医疗！山...
近日，山一大一附院（省千佛山医院）“基于安全可信框架的分布式大模型算力服务项目”已完成招标，后续建设...
乔路铭开启申购即将登陆北交所：...
拥有已授权专利113项，构建起覆盖主流车企的供应体系。 2026年7月8日，乔路铭科技股份有限公司（...
燧原科技科创板IPO注册获证监...
证监会批复同意燧原科技科创板IPO注册。 7月9日晚间，证监会发布《关于同意上海燧原科技股份有限公司...
13年全职太太出任董事，营销总...
来源丨时代商业研究院 作者丨陆烁宜 编辑丨郑琳 IPO前连续3年大笔分红后欲募资补流，合理性遭遇北交...
年内“再卸一基”！广发明星基金...
红星资本局7月9日消息，近日，广发基金公告称，基金经理郑澄然“再卸一基”，不再管理广发兴诚混合（基金...
活力中国调研行 | 在上海，答...
【大河财立方 记者 夏晨翔 文 王子阳 摄影】“遂古之初，谁传道之？上下未形，何由考之？”2300年...
原创 2...
美联储新掌门凯文·沃什开完首场议息会，点阵图直接抹掉今年降息预期，9名票委还支持年内再加，美元指数当...
快餐、烘焙之后，商超巨头们又看...
文 | 红餐网 “15.8元自选快餐”“18元韩国拌饭”“青蟹98元一只现捞现蒸”，消费者推着购物...
从工业重镇到“场景招商” “铜...
中新网兰州7月9日电 (杨娜)第三十二届中国兰州投资贸易洽谈会9日在兰州启幕，素有“铜城”美誉之称的...