设施详情接口
接口地址：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
错误信息
发表回复