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-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signStringMob后台的MobAppSecret md5(由于不需要参数所以直接对Secret进行md5)

请求参数:无

返回参数说明

参数名参数类型参数说明
registrationIdStringrid 用户客户端获取的registrationId
tagsString[]设备标签数组
aliasString设备别名
mobileString手机号码( 用于短信补量等功能)
openPushnumber是否开启推送 1:开启,0:关闭
statusnumber设备状态 1:正常,3:卸载,0:删除(卸载统计未开通)

根据别名查询设备信息

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

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

请求方式:GET

接口访问频率限制:受限,参照接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signStringMob后台的MobAppSecret md5(由于不需要参数所以直接对Secret进行md5)

请求参数:无

返回参数说明

参数名参数类型参数说明
registrationIdStringrid 用户客户端获取的registrationId
tagsString[]设备标签数组
aliasString设备别名
mobileString手机号码( 用于短信补量等功能)
openPushnumber是否开启推送 1:开启,0:关闭
statusnumber设备状态 1:正常,3:卸载,0:删除(卸载统计未开通)

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

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

请求方式:POST

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

接口访问频率限制:受限,参照接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数:

参数名参数类型是否必要参数参数说明
appkeyStringMob后台的MobAppKey
tagsString[]标签数组,交集查询,需要与rid下的tags全部匹配

返回参数说明

参数名参数类型参数说明
registrationIdStringrid 用户客户端获取的registrationId
tagsString[]设备标签数组
aliasString设备别名
mobileString手机号码( 用于短信补量等功能)
openPushnumber是否开启推送 1:开启,0:关闭
statusnumber设备状态 1:正常,3:卸载,0:删除(卸载统计未开通)

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

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

请求方式:GET

接口访问频率限制:受限,参照接口频率限制

请求头部:

参数名参数类型参数说明
keyStringMob后台的MobAppKey
signStringMob后台的MobAppSecret md5(由于不需要参数所以直接对Secret进行md5)

请求参数:无

返回参数说明

参数名参数类型参数说明
openPushnumber打开推送权限设备数量
closePushnumber关闭推送权限设备数量
uninstallnumber卸载设备数量(功能未开通)

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

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

请求方式:POST

接口访问频率限制:受限,参照接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数:

参数名参数类型是否必要参数参数说明
appkeyStringMob后台的MobAppKey
registrationIdString用户客户端口获取的registrationId
opTypenumber操作类型:1新增标签;2删除标签;3清空标签
tagsString[]标签数组(opType类型为3时候不用传入)

返回参数:

参数名参数类型参数说明
statusnumbersatus=200 成功
resobject暂时返回为null
errorString返回error

设置别名

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

请求方式:POST

接口访问频率限制:受限,参照接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数:

参数名参数类型是否必要参数参数说明
appkeyStringMob后台的MobAppKey
registrationIdString用户客户端口获取的registrationId
aliasString需要设置的别名

返回参数:

参数名参数类型参数说明
statusnumbersatus=200 成功
resobject暂时返回null
errorString返回error

推送任务状态(根据workId查询 workId为推送任务ID)

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
workIdString推送任务的唯一任务id

请求示例

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

返回参数说明

参数名参数类型说明
statusnumber状态码
resstring任务状态:”发送完成“、“取消成功”、“创建中”、“等待发送”、“发送中”、“发送完成”、“发送失败”、“停止发送”、“已取消”、 “取消成功”、“已撤回”、“下发失败”
errorstring报错信息(正常情况值为null)

推送详情(根据workId查询 workId为推送任务ID)

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
workIdString推送任务的唯一任务id

请求示例

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

返回参数说明

参数名参数类型说明
statusInt状态码
iosobjectiOS的统计可以参考下面展开参数
fetchNumint返回的设备数量
deliverNumint实际下发的设备数量
deliverFailNumint下发失败的数量
reportNumint下发后回执的数量 (iOS回执不准确或者为0仅供参考)
reportFailNumint下发后回执失败的数量
clickNumint点击通知的数量
androidobject安卓的统计可以参考上面iOS展开参数
factoryobject通过厂商和APNS下发的统计 参考同上
mobpushobject通过MobPush通道下发的统计 参考同上
iostcpobject通过MobPush通道下发iOS的统计 参考同上
androidtcpobject通过MobPush通道下发Android的统计 参考同上
apnsobject通过APNS下发的统计 参考同上
huaweiobject通过华为厂商下发的统计 参考同上
xiaomiobject通过小米厂商下发的统计 参考同上
flymeobject通过魅族厂商下发的统计 参考同上
fcmobject通过谷歌厂商下发的统计 参考同上
oppoobject通过oppo厂商下发的统计 参考同上
vivoobject通过vivo厂商下发的统计 参考同上
smsobject短信补量下发统计
offlineIosobjectiOS离线统计
offlineAndroidobject安卓离线统计

推送详情(根据workId数组查询 workId为推送任务ID)

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
workIdsString[]推送任务id的数组

请求示例

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

返回参数说明

参数名参数类型说明
statusInt状态码
iosobjectiOS的统计可以参考下面展开参数
fetchNumint返回的设备数量
deliverNumint实际下发的设备数量
deliverFailNumint下发失败的数量
reportNumint下发后回执的数量 (iOS回执不准确或者为0仅供参考)
reportFailNumint下发后回执失败的数量
clickNumint点击通知的数量
androidobject安卓的统计可以参考上面iOS展开参数
factoryobject通过厂商和APNS下发的统计 参考同上
mobpushobject通过MobPush通道下发的统计 参考同上
iostcpobject通过MobPush通道下发iOS的统计 参考同上
androidtcpobject通过MobPush通道下发Android的统计 参考同上
apnsobject通过APNS下发的统计 参考同上
huaweiobject通过华为厂商下发的统计 参考同上
xiaomiobject通过小米厂商下发的统计 参考同上
flymeobject通过魅族厂商下发的统计 参考同上
fcmobject通过谷歌厂商下发的统计 参考同上
oppoobject通过oppo厂商下发的统计 参考同上
vivoobject通过vivo厂商下发的统计 参考同上
smsobject短信补量下发统计
offlineIosobjectiOS离线统计
offlineAndroidobject安卓离线统计

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

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
worknoString用户的推送任务id

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

推送详情(按小时查询)

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
hourString时间精确到小时yyyyMMddHH 例如2020082415 查询2020年08月24日 15点钟的所有推送

请求示例

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

返回参数说明

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
fetchNumnumber总设备数
fetchNumAndroidnumber安卓的设备数量
fetchNumIosnumberiOS的推送设备数量
workNumnumber推送任务熟练
workNumAndroidnumber推送给安卓的任务数量
workNumIosnumber推送给iOS的任务数量
deliverNumTcpnumber通过TCP通道(MobTech的通道)下发的数量
reportNumTcpnumberTCP回调的数量
clickNumTcpnumberTCP通道点击通知的数量
deliverNumnumber消息下发总数量
deliverNumAndroidnumber安卓消息下发数量
deliverNumIosnumberiOS消息下发数量
reportNumnumber推送回执数量
reportNumAndroidnumber安卓推送回执数量
reportNumIosnumberiOS推送回执数量(iOS 下发回执不准确仅供参考也可能为0)
clickNumnumber推送点击数量
clickNumAndroidnumber安卓推送点击数量
clickNumIosnumberiOS推送点击数量
apiNumnumberapi调用次数
apiNumAndroidnumber安卓api调用次数
apiNumIosnumberiOSapi调用次数
activeNumnumber设备活跃数量
activeNumAndroidnumber安卓设备活跃量
activeNumIosnumberiOS设备活跃数量
newDeviceNumnumber新增设备数量
newDeviceNumAndroidnumber新增安卓设备数量
newDeviceNumIosnumber新增iOS设备数量
onlineTimeAvgnumber设备平均在线时长
onlineTimeAvgAndroidnumber安卓设备平均在线时长
onlineTimeAvgIosnumberiOS设备平均在线时长
onlineTimeAllnumber设备在线总时长(优化中)
onlineTimeAllAndroidnumber安卓设备在线总时长(优化中)
onlineTimeAllIosnumberiOS设备在线总时长(优化中)
openAppAvgnumberapp平均打开次数(即启动应用次数)
openAppAvgIosnumberiOS app平均打开次数
openAppAvgAndroidnumber安卓app平均打开次数
openAppAllnumber设备打开app总次数
openAppAllAndroidnumber安卓app 打开总次数
openAppAllIosnumberiOS app打开总次数次数

推送详情(按日期查询)

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
dayString时间精确到小时yyyyMMdd 例如20200824 查询2020年08月24日 24号的所有推送

请求示例

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

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

推送详情(查询每次下发的设备信息)

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

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
workIdString推送的任务id
pageIndexnumber页码
pageSizenumber页面条数

请求示例

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

返回参数说明

参数名参数类型说明
totalPagesnumber返回总的页数
totalnumber返回设备的总数
contentobject[]返回的下发设备信息数组
ridString设备的绑定id 可以在客户端打印获取
workIdString任务id
aliasString设备别名
tagString标签
idString设备id
patchIdString推送批次id(暂时是MobTech内部自己使用的字段)
deliverString[]下发类型如["apns"]
deliverTimenumber下发次数
reportString[]下发回执类型
reportTimenumber回执次数
clickString[]点击类型
clickTimenumber点击次数

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

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

请求方式:POST

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringMob后台的MobAppKey
activityWorkIdString推送的活动任务id

请求示例

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

返回参数说明

参数名参数类型说明
statusnumber200
resobject[]res
appkeystringMob的appkey
activityWorkIdstring活动任务id
fetchNumnumber目标数
deliverNumnumber下发数
reportNumnumber到达数
clickNumnumber点击数
errornullerror

其他接口

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

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
schemeStringscheme地址
schemeDataListobject[]scheme参数
keyString
valueString

请求示例

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

返回参数说明

参数名参数类型说明
statusInt状态码
resobject []返回值
channelstring厂商
maxLengthstring厂商最大支持长度
currentLengthstring当前长度
tooLongboolean是否超长
errorstring错误信息

FileId上传文件

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

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

请求方式:POST

接口访问频率限制:受限,参照 接口频率限制

请求头部

参数名参数类型参数说明
Content-Typeapplication/json必要参数
keyStringMob后台的MobAppKey
signString请求参数+MobAppSecret md5

请求参数

参数名参数类型参数说明
appkeyStringAppKey
typenumber1rid;2alias
uploadDatastring []上传的rid或者别名

请求示例

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

返回参数说明

参数名参数类型说明
statusInt状态码
resstringfileId
errorstring错误信息

相关内容

热门资讯

商业航天景气高企,军工ETF广... 截止2月4日10点20分,上证指数涨0.36%,深证成指跌0.45%,创业板指跌1.35%。煤炭开采...
原创 《... 1953年,张乐平创作的漫画《三毛流浪记》问世,伴随抗战胜利的喜讯,它更是在《大公报》上连载,从此三...
传马斯克团队密访中国多家光伏企... 【CNMO科技消息】2月4日,据“能见派”报道,有消息人士透露,马斯克团队近期秘密走访了中国多家光伏...
构建“三条增长曲线”,中健康桥... 图片来源:视觉中国 2025年6月,新三板挂牌企业中健康桥医药集团股份有限公司(以下简称“中健康桥”...
元宝红包链接遭微信屏蔽 来源:猎云网 2月4日上午,猎云网注意到,在微信群里分享的元宝红包已无法直接打开,页面提示:网页包含...
彩客科技IPO:顺应“十五五”... 中国上市公司网/文 在全球产业格局深度调整、我国经济向高质量发展迈进的宏大背景下,“十五五”规划为...
2025年,北方大省的经济突围 原创 周小铃 南方周末 ▲ 在GDP总量前十的经济大省中,河南增速最高。图为郑州动车。(视觉中国/...
ETF盘中资讯|消费旺季点燃吃... 吃喝板块今日(2月4日)继续走强!反映吃喝板块整体走势的食品饮料ETF华宝(515710)开盘后震荡...
上海计划回收二手房,市场要变天... 2月2日晚,上海抛出一颗楼市重磅炸弹: 由官方牵头收购二手房,用于保障性租赁住房,首批试点覆盖浦东、...
大跌后反弹!金价重回4800美... 2月3日,国际金银价格在经过近日大跌后迎来反弹,金价一度突破4850美元/盎司,银价也达一度超过85...
人工智能概念股走弱,创业板人工... 人工智能概念股走弱,新易盛跌超7%,中际旭创跌超6%,北京君正、润泽科技跌超4%。 受盘面影响,创业...
现货黄金反弹,商品黄金相关ET... 2月4日,现货黄金日内涨幅扩大至2%,场内商品黄金相关ETF大涨超3%。 多家国际投行的分析指出,...
原创 S... 埃隆·马斯克将太空探索技术公司与他那资金消耗巨大的人工智能企业 xAI 进行合并的举动,表明其商业帝...
“红利一哥”中证红利质量ETF... 2月4日,煤炭起舞!数据显示,截至10时15分,“红利一哥”中证红利质量ETF(159209)涨0....
中际旭创、新易盛均跌超9% 2月4日,指数分化,创业板指下挫跌逾2%,沪指涨0.02%,深成指跌1.08%。算力硬件、半导体芯片...
美国纳斯达克证券交易所上市指南 纳斯达克(NASDAQ)作为全球最大的股票电子交易市场之一,自1971年成立以来,一直是全球金融市场...
明智科技42岁女副总韦晶晶兼任... 瑞财经 吴文婷近日,明智科技股份有限公司(以下简称“明智科技”)在港交所递交招股书,建银国际为其独家...
青岛农商银行:选举梁衍波为董事... 中国网财经2月4日讯 2月3日,青岛农商银行发布第五届董事会第十七次临时会议决议公告,会议审议并通过...
外汇黄金入门真的很难吗?关键不... 近几年,外汇投资正在从“小众专业领域”,逐步进入普通投资者的视野。一方面,全球经济不确定性增加,汇率...
首亏撞上三连阳,润都股份减持暗... 图片由AI生成 市场仿佛捕捉到了国产核药破局的曙光。2月2日,润都股份(002923.SZ)发布股票...