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

请求参数:

参数名参数类型是否必要参数参数说明
appkeyString否Mob后台的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

请求参数:

参数名参数类型是否必要参数参数说明
appkeyString是Mob后台的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

请求参数:

参数名参数类型是否必要参数参数说明
appkeyString否Mob后台的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错误信息

相关内容

热门资讯

蜻蜓订购APP贵金属订购非法期...   蜻蜓订购APP以"投资平台"名义对外宣传,主打贵金属期货(订购)交易。该平台一方面强调自身"正规...
悟空订购APP非法期货交易欺骗...   近期,有投资者反映,“悟空订购APP”等平台以白银、贵金属订购为名,宣传所谓“高收益”“低门槛”...
小赢淘金APP期货投资骗局,平...   “小赢淘金”之流,最擅长的就是用“注册送现金”、“充值返券”的糖衣炮弹来引流。别天真地以为那是福...
八方淘金APP非法期货交易欺骗...   警惕!八方生财、每日淘金、小赢淘金、悟空订购、蜻蜓订购、斗金订购等APP均涉嫌非法期货交易!  ...
智易购APP贵金属订购交易骗局...   很多人看到“3元起投”“充值送福利”“操作简单”“随时提现”这类宣传,很容易把智易购APP当成普...
喜玛银庄APP商品订购投资骗局...   喜玛银庄APP白银、铂金“现货订购”骗局警示:无资质平台涉嫌非法期货交易,投资者爆仓后如何维权?...
吉鑫乐享APP炒贵金属订购交易...   近期,多名投资者反映在“吉鑫乐享APP”进行贵金属投资时遭遇严重亏损,甚至血本无归。看似正规的“...
易掘金APP虚假期货投资骗局,...   “易掘金”的APP它打着“高收益、灵活投资”的旗号,宣称通过“商品订购”就能轻松赚钱,吸引了不少...
在大吉订购APP订购交易亏损被...   近期,不少投资者反映在“大吉订购App”上投资白银、铂金等商品遭遇严重亏损。该平台宣称提供现货订...
铂银壹号APP商品订购交易亏损...   许多中小投资者误以为网上的“商品现货订购”是合规合法的理财渠道,殊不知这背后隐藏着巨大的合规风险...
兴鑫淘金APP贵金属订购交易亏...   白银、贵金属或其他商品类投资,除国家批准的正规期货交易场所及持牌期货公司外,市面上大量第三方交易...
铂银掘金APP无资质的违规平台...   铂银掘金等平台的投资者,往往是被“注册送现金”“充值返现券”“首单免亏”等广告话术吸引,进而下载...
八方淘金APP订购交易不合规,...   “八方淘金APP”“铂银掘金APP”“铂银壹号APP”等软件被指以“现货订购”为名,实际采用高杠...
在指尖订购APP订购商品亏损被...   指尖订购APP这类平台,表面是“订购交易”,实则是披着电商外衣的非法期货陷阱。绝大多数投资者被蒙...
在犀贝易购APP做商品订购交易...   市面上打着“现货投资”“贵金属交易”旗号的APP并不少,但真正合规、受监管的平台并不多。犀贝易购...
易达淘金APP虚假商品订购交易...   易达淘金APP存在严重的虚假宣传与违规交易行为。该平台打着“商品订购”的旗号,实则通过不合规的交...
大浪淘金APP白银订购亏损被骗...   大浪淘金APP最隐蔽的套路,在于其完全封闭的内盘交易系统。表面上,它宣称与国际贵金属市场接轨;实...
一品好购APP上订购白银出现亏...   一品好购APP原名“一品订购”,运营方为上海宝智未来信息技术有限公司。近期不少投资者反映在该平台...
九州订购APP贵金属订购投资骗...   九州订购APP正通过抖.音、快手、今日头条等平台大量投放投资广告,用“5元起投”“充值返现”“0...
坚锅淘金APP交易软件并不正规...   当前,市面上大量所谓的“现货商城订购”交易软件,早已偏离了正常的实物商品买卖,演变为高杠杆、高手...