Cobub文档中心

用户工具

站点工具

侧边栏

文档首页

Cobub Razor

Cobub Toaster

其它链接

这是本文档旧的修订版！

目录

Cobub Razor API 手册

1 API列表

v0.7.1

接口名 描述
getproductlist 获取可访问的应用列表
getversionlist 获取所有版本列表
getchannellist 获取所有渠道列表
getbasicdata 获取基础数据
getbasicdatabychannel 获取基础数据（按渠道划分）
getbasicdatabyversion 获取基础数据（按版本划分）
getactiveratio 获取最近一周/月的活跃率
getchannelactiveratio 获取各版本本周/本月的活跃用户数和活跃率
getfrequency 获取使用频率数据
getusingtime 获取使用时长数据
getdatabyhour 获取小时的数据
getpagedata 获取页面访问数据
getcountry 获取地域分析数据（国家）
getregion 获取地域分析数据（省份）
getretention 获取用户留存数据
getdevicebrand 获取终端名称数据
getdeviceosversion 获取终端操作系统版本数据
getdeviceresolution 获取终端分辨率数据
getdevicecarrier 获取终端运营商数据
getdevicenetwork 获取终端联网方式数据
geteventdata 获取事件数据
geteventdetail 获取单一事件详细数据
getconversionlist 获取转化率列表
getconversiondetail 获取转化率详细信息
geterrorbyversion 获取错误信息（按版本）
geterrordetailbyversion 获取错误详细信息（按版本）
geterrordetaillistbyversion 获取错误详细列表（按版本）
geterrordistributionbyversion 获取错误在操作系统和设备的分布情况（按版本）
geterrorbyosversion 获取错误信息（按操作系统版本）
geterrordetailbyosversion 获取错误详细信息（按操作系统版本）
geterrordetaillistbyosversion 获取错误详细列表（按操作系统版本）
geterrordistributionbyversion 获取错误在版本和设备的分布情况（按操作系统版本）
geterrorbydevice 获取错误信息（按设备）
geterrordetailbydevice 获取错误详细信息（按设备）
geterrordetaillistbydevice 获取错误详细列表（按设备）
geterrordistributionbydevice 获取错误在版本和操作系统版本的分布情况（按设备）

OpenAPI接口调用通过JSON格式的HTTP协议，请确保将JSON内容放到HTTP的BODY中，并以content=为后缀。如下：

POST Body: content={“user”:”userA”,”password”:”pwd”}

1.1 用户验证

login

1.1.1 功能说明

用户登录验证。

1.1.2 调用说明

1.1.2.1 请求方式

post

1.1.2.2 请求地址

PREURL/api/login （PEURL为所安装的Cobub Razor网址前缀，如http://localhost/web/index.php，下同 1.1.3 参数

字段名称 数据类型 描述 是否必须
username String cobub账号用户名 是
password String 经md5加密后的密码 是

发送数据JSON实例： 

{

“username”:”admin”,

“password”:”765E5A00B76FF4ECA098BB”

}

1.1.4 返回结果

字段名称 数据类型 描述 是否必须
flag String 标识，>0成功，<0失败 是
msg String 提示信息 是
sessionkey String API调用时参数项 是

返回数据JSON实例：

成功： 

{

“flag”:”1″,

“msg”:”用户验证成功”,

“sessionkey”:”A7E76DD709C0B1A”

}

失败： 

{

“flag”:”-1″,

“msg”:”用户名不存在”

}

错误类型：

Flag Msg 说明
-1 username not exists 用户名不存在
-2 invalid password 密码错误
-3 too many login attempts 错误登录次数过多
-4 DB Error数据库错误

1.2 获取可访问的应用列表

getproductlist

1.2.1 功能说明

获取所有的应用列表。

1.2.2 调用说明

1.2.2.1 请求方式

post

1.2.2.2 请求地址

PREURL/api/getproductlist

1.2.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是

发送数据JSON实例： 

{

“sessionkey”: “765E5A00B76FF4ECA098BB”

}

1.2.4 返回结果

字段名称 数据类型 描述 是否必须
flag String 标识，>0成功，且为queryresult的size，<0失败， 是
msg String 提示信息 是
sessionkey String API调用时参数项 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryresult”: [

{

"platform": "iOS",

"productid": "1",

"productname": "name1"

},

{

"platform": "Android",

"productid": "2",

"productname": "name2"

}

]

}

错误返回： 

{

“flag”:”-1″,

“msg”:”用户名不存在”

}

错误类型定义：

Flag Msg 说明
-1 JSON format is not correct JSON数据格式错误
-2 Sessionkey is invalide Sessionkey无效
-3 DB Error 数据库错误
-4 Network error 网络错误

1.3 获取所有版本列表

getversionlist

1.3.1 功能说明

根据productid获取该product的所有版本信息。

1.3.2 调用说明

1.3.2.1 请求方式

post

1.3.2.2 请求地址

PREURL/api/getversionlis

1.3.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key是
productid String productid 是

发送数据JSON实例： 

{

“sessionkey”: “765E5A00B76FF4ECA098BB”,

“productid”:”1″

}

1.3.4 返回结果

字段名称 数据类型 描述
flag String 标识，>0成功，且为queryresult的size，<0失败，=0表示0个版本，没有queryresult 是
msg String 提示信息 是
queryresult JSONArray Version列表 否
versionString version名称是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"version": "0.1"

},

{

"version": "0.2"

}

]

}

错误返回： 

{

“flag”:”-1″,

“msg”:”格式不正确”

}

错误类型定义：

Flag Msg 说明
-1 JSON format is not correct JSON数据格式错误
-2 Sessionkey is invalide Sessionkey无效
-3 DB Error 数据库错误
-4 Network error 网络错误

1.4 获取所有渠道列表

getchannellist

1.4.1 功能说明

根据productid获取该product的所有渠道信息。

1.4.2 调用说明

1.4.2.1 请求方式

post

1.4.2.2 请求地址

PREURL/api/getchannellist

1.4.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String productid 是

发送数据JSON实例： 

{

“sessionkey”: “765E5A00B76FF4ECA098BB”,

“productid”:”1″

}

1.4.4 返回结果

字段名称 数据类型 描述 是否必须
flag String 标识，>0成功，且为queryresult的size，<0失败，=0表示0个版本，没有queryresult 是
msg String 提示信息 是
queryresult JSONArray Version列表 否
id String channel ID 是
name String channel Name 是

返回数据JSON实例：

成功返回1： 

{

“flag”: “2″,

“queryResult”: [

{

"id": "1",

"name":"机锋市场"

},

{

"id": "2",

"name":"安卓市场"

}

]

}

成功返回2： 

{

“flag”: “0″,

“queryResult”:””

}

错误返回： 

{

“flag”:”-1″,

“msg”:”格式不正确”

}

错误类型定义：

Flag Msg 说明
-1 JSON format is not correct JSON数据格式错误
-2 Sessionkey is invalide Sessionkey无效
-3 DB Error 数据库错误
-4 Network error 网络错误

1.5 获取基础数据

getbasicdata

1.5.1 功能说明

根据productid获取某时间段内该product的启动次数、活跃用户、新用户、平均使用时长、升级用户、累计用户。

1.5.2 调用说明

1.5.2.1 请求方式

post

1.5.2.2 请求地址

PREURL/api/getbasicdata

1.5.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”: “765E5A00B76FF4ECA098BB”,

“productid”:”1″,

“startdate”:”2013-1-1″,

“enddate”:”2013-1-2″

}

1.5.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，且为queryresult的size，<0失败，=0表示0个版本，没有queryresult 是
msg String 提示信息 是
queryresult JSONArray Version列表 否
date String 日期 是
sessions String 启动次数 是
activeusers String 活跃用户数 是
newusers String 新增用户数 是
usingtime String 使用时长 是
allusers String 累计用户数 是
upgradeusers String 升级用户数 是

返回数据JSON实例：

成功返回： 

{

“flag”: 2,

“queryResult”: [

{

"date":"2013-1-1",

"sessions": 10,

"activeusers": 10,

"newusers": 10,

"usingtime": 10,

"allusers": 10,

"upgradeusers": 10

},

{

"date":"2013-1-2",

"sessions": 10,

"activeusers": 10,

"newusers": 10,

"usingtime": 10,

"allusers": 10,

"upgradeusers": 10

}

]

}

错误返回： 

{

“flag”:”-1″,

“msg”:”格式不正确”

}

错误类型定义：

Flag Msg 说明
-1 JSON format is not correct JSON数据格式错误
-2 Sessionkey is invalide Sessionkey无效
-3 DB Error 数据库错误

1.6 获取基础数据（按渠道划分）

getbasicdatabychannel

1.6.1 功能说明

根据productid在指定时间段下所有渠道下的启动次数、活跃用户数、新用户数、平均使用时长、累计用户数、累计启动次数。

1.6.2 调用说明

1.6.2.1 请求方式

post

1.6.2.2 请求地址

PREURL/api/getbasicdatabychannel

1.6.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“enddate”: “2013-4-2″,

“productid”: “123″,

“startdate”: “2013-4-1

}

1.6.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，且为queryResult的size<0失败 是
queryResult JSONArray 详细信息,queryresult为JSONArray对象flag对应值：大于等于0为queryresult数组的长度,包括channelid的数组 是
datevalue String 日期 是
sessions String 启动次数 是
activeusers String 活跃用户数 是
newusers String 新用户数 是
usingtime String 使用时长 是
allusers String 累计用户数 是
upgradeusers String 升级用户数 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"1": [

{

"datevalue": "20120101",

"activeusers": "10",

"newusers": "0",

"sessions": "10",

"upgradeusers": "10",

"allusers": "10",

"allsessions": "10",

"usingtime": "10"

},

{

"datevalue": "20120102",

"activeusers": "10",

"newusers": "0",

"sessions": "10",

"upgradeusers": "10",

"allusers": "10",

"allsessions": "10",

"usingtime": "10"

}

],

“2″: [

{

"datevalue": "20120101",

"activeusers": "10",

"newusers": "0",

"sessions": "10",

"upgradeusers": "10",

"allusers": "10",

"allsessions": "10",

"usingtime": "10"

},

{

"datevalue": "20120102",

"activeusers": "10",

"newusers": "0",

"sessions": "10",

"upgradeusers": "10",

"allusers": "10",

"allsessions": "10",

"usingtime": "10"

}

]

}

]

}

1.7 获取基础数据（按版本划分）

getbasicdatabyversion

1.7.1 功能说明

根据productid在指定时间段下所有版本下的启动次数、活跃用户数、新用户数、平均使用时长、累计用户数、累计启动次数。

1.7.2 调用说明

1.7.2.1 请求方式

post

1.7.2.2 请求地址

PREURL/api/getbasicdatabyversion

1.7.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.7.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，且为queryResult的size<0失败 是
queryResult JSONArray 详细信息,queryresult为JSONArray对象flag对应值：大于等于0为queryresult数组的长度,包括version的数组 是
datevalue String 日期 是
activeusers String 活跃用户数 是
newusers String 新用户数 是
sessions String 启动次数 是
upgradeusers String 升级用户数 是
allusers String 累计用户数 是
allsessions String 累计启动次数 是
usingtime String 使用时长 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"0.1": [

{

"datevalue": "20120101",

"activeusers": "10",

"newusers": "0",

"sessions": "10",

"upgradeusers": "10",

"allusers": "10",

"allsessions": "10",

"usingtime": "10"

},

{

"datevalue": "20120102",

"activeusers": "10",

"newusers": "0",

"sessions": "10",

"upgradeusers": "10",

"allusers": "10",

"allsessions": "10",

"usingtime": "10"

}

],

“0.2″: [

{

"datevalue": "20120101",

"activeusers": "10",

"newusers": "0",

"sessions": "10",

"upgradeusers": "10",

"allusers": "10",

"allsessions": "10",

"usingtime": "10"

},

{

"datevalue": "20120102",

"activeusers": "10",

"newusers": "0",

"sessions": "10",

"upgradeusers": "10",

"allusers": "10",

"allsessions": "10",

"usingtime": "10"

}

]

}

]

}

1.8 获取最近一周/月的活跃率

getactiveratio

1.8.1 功能说明

根据productid获取最近一周/月的活跃用户数和活跃率。

1.8.2 调用说明

1.8.2.1 请求方式

post

1.8.2.2 请求地址

PREURL/api/getactiveratio

1.8.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″

}

1.8.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
wusers String 周活跃用户数 是
musers String 月活跃用户数 是
wuserpercent String 周活跃用户率 是
muserpercent String 月活跃用户率 是

返回数据JSON实例：

成功返回： 

{

“flag”: “1″,

“wusers”: “100″,

“musers”: “1029″,

“wuserpercent”: “0.31″,

“muserpercent”: “0.32″

}

1.9 获取各版本本周/本月活跃率

getchannelactiveratio

1.9.1 功能说明

根据productid获取最近一周/月的活跃用户数和活跃率。

1.9.2 调用说明

1.9.2.1 请求方式

post

1.9.2.2 请求地址

PREURL/api/getchannelactiveratio

1.9.3 参数

字段名称 数据类型 描述 是否必须
sessionkey int 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
type String week/month 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″，

“startdate”: “2013-1-1″，

“enddate”: “2013-4-1″，

“type”: “week”，

}

1.9.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
datevalue String 日期 是
activeusers String 周活跃用户/月活跃用户数
rate String 周活跃率/月活跃率 是
channelid String 渠道ID 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"1": [

{

"datevalue": "2013-1-1",

"activeusers": "100",

"rate": 0.03

},

{

"datevalue": "2013-1-8",

"activeusers": "100",

"rate": 0.02

},

{

"datevalue": "2013-1-15",

"activeusers": "100",

"rate": 0.03

}

],

“2″: [

{

"datevalue": "2013-1-1",

"activeusers": "100",

"rate": 0.03

},

{

"datevalue": "2013-1-8",

"activeusers": "100",

"rate": 0.03

},

{

"datevalue": "2013-1-15",

"activeusers": "100",

"rate": 0.03

}

]

}

]

}

1.10 获取使用频率数据

getfrequency

1.10.1 功能说明

根据productid获取时间段内的使用频率。

1.10.2 调用说明

1.10.2.1 请求方式

post

1.10.2.2 请求地址

PREURL/api/getfrequency

1.10.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.10.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
segment_sk String 频率分布id 是
segment_name String 频率分布名称 是
access String 访问次数 是
percentage String 所占比例 是

返回数据JSON实例：

成功返回： 

{

“flag”: 6,

“queryResult”: [

{

"segment_sk": "1",

"segment_name": "1-2次",

"access": 17,

"percentage": 0.017

},

{

"segment_sk": "2",

"segment_name": "3-5次",

"access": 25,

"percentage": 0.025

},

{

"segment_sk": "3",

"segment_name": "6-9次",

"access": 38,

"percentage": 0.038

},

{

"segment_sk": "4",

"segment_name": "10-19次",

"access": 109,

"percentage": 0.109

},

{

"segment_sk": "5",

"segment_name": "20-49次",

"access": 307,

"percentage": 0.307

},

{

"segment_sk": "6",

"segment_name": "50次以上",

"access": 504,

"percentage": 0.504

}

]

}

1.11 获取使用时长数据

getusingtime

1.11.1 功能说明

根据productid获取时间段内的使用时长分布。

1.11.2 调用说明

1.11.2.1 请求方式

post

1.11.2.2 请求地址

PREURL/api/getusingtime

1.11.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.11.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
segment_sk String 频率分布id 是
segment_name String 频率分布名称 是
numbers String 使用次数 是
percentage String 所占比例 是

返回数据JSON实例： 成功返回： 

{

“flag”: 6,

“queryResult”: [

{

"segment_sk": 1,

"segment_name": "0-3",

"numbers": 3,

"percentage": 0.03

},

{

"segment_sk": 2,

"segment_name": "3-10",

"numbers": 11,

"percentage": 0.01

},

{

"segment_sk": 3,

"segment_name": "10-30",

"numbers": 40,

"percentage": 0.04

},

{

"segment_sk": 4,

"segment_name": "30-60",

"numbers": 110,

"percentage": 0.13

},

{

"segment_sk": 5,

"segment_name": "60-180",

"numbers": 379,

"percentage": 0.46

},

{

"segment_sk": 6,

"segment_name": "180",

"numbers": 279,

"percentage": 0.33

}

]

}

1.12 获取小时的数据

getdatabyhour

1.12.1 功能说明

根据productid获取时间段内的24小时的使用分布情况。

1.12.2 调用说明

1.12.2.1 请求方式

post

1.12.2.2 请求地址

PREURL/api/getdatabyhour

1.12.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.12.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
segment_sk String 频率分布id 是
segment_name String 频率分布名称 是
numbers String 使用次数 是
percentage String 所占比例 是

返回数据JSON实例：

成功返回： 

{

“flag”: 1,

“activeuser”: {

“1″: 30,

“2″: 20,

“3″: 33,

“4″: 33,

…

“23″: 2

},

“newuser”: {

“1″: 30,

“2″: 20,

“3″: 33,

“4″: 33,

…

“23″: 2

},

“sessions”: {

“1″: 30,

“2″: 20,

“3″: 33,

“4″: 33,

…

“23″: 2

}

}

1.13 获取页面访问数据

getpagedata

1.13.1 功能说明

根据productid和version获取时间段内的页面访问详细。

1.13.2 调用说明

1.13.2.1 请求方式

post

1.13.2.2 请求地址

PREURL/api/getpagedata

1.13.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
version String 版本号，为空时指所有版本 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“version”:”0.1″

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

}

1.13.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
activity String 页面名称 是
exitcount String 在activity退出次数 是
count String 访问activity次数 是
duration String 在activity中持续时长 是

返回数据JSON实例：

成功返回： 

{

“flag”: 1,

“queryResult”: [

{

"activity": "MainActivity",

"exitcount": 3,

"count": 33,

"duration": 233

},

{

"activity": "AboutActivity",

"exitcount": 3,

"count": 33,

"duration": 233

}

]

}

1.14 获取地域分析数据（国家）

getcountry

1.14.1 功能说明

根据productid获取时间段内获取前N(由limit决定)国家的分布数据。

1.14.2 调用说明

1.14.2.1 请求方式

post

1.14.2.2 请求地址

PREURL/api/getcountry

1.14.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
limit String Top N 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“limit”:”10″

}

1.14.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
newusers JSONArray 新增用户数 是
activeusers JSONArray 活跃用户数 是
num String 使用次数 是
country String 国家名称 是
id String 序号，倒排，num最大排在最前面 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"newusers": [

{

"id": "1",

"country": "Bangladesh",

"num": 0

},

{

"id": "2",

"country": "China",

"num": 0

},

{

"id": "3",

"country": "",

"num": 0

}

],

“activeusers”: [

{

"id": "1",

"country": "British",

"num": 343

},

{

"id": "2",

"country": "China",

"num": 22

},

{

"id": "3",

"country": "Bangladesh",

"num": 1

}

]

}

]

}

1.15 获取地域分析数据（省份）

getregion

1.15.1 功能说明

根据productid和国家(country)获取时间段内获取前N(由limit决定)省市的分布数据。

1.15.2 调用说明

1.15.2.1 请求方式

post

1.15.2.2 请求地址

PREURL/api/getregion

1.15.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
country String 国家名称，需与getcountry输出的名称一致 是
limit String Top N 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“country”:”China”,

“limit”:”10″

}

1.15.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
newusers JSONArray 新增用户数 是
activeusers JSONArray 活跃用户数 是
num String 使用次数 是
province String 省市名称 是
id String 序号，倒排，num最大排在最前面 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"newusers": [

{

"id": "1",

"province": "Jiangsu",

"num": 0

},

{

"id": "2",

"province": "Beijing",

"num": 0

},

{

"id": "3",

"province": "Sichuan",

"num": 0

}

],

“activeusers”: [

{

"id": "1",

"province": "Jiangsu",

"num": 343

},

{

"id": "2",

"province": "Beijing",

"num": 22

},

{

"id": "3",

"province": "Sichuan",

"num": 1

}

]

}

]

}

1.16 获取用户留存数据

getretention

1.16.1 功能说明

根据productid获取时间段内的用户留存。

1.16.2 调用说明

1.16.2.1 请求方式

post

1.16.2.2 请求地址

PREURL/api/getretention

1.16.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
type String 月:month或周:week 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“type”:”week”

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“type”:”month”

}

1.16.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult String 是
startdate JSONArray 时间段开始日期 是
enddate String 时间段结束日期 是
newusers String 新用户数 是
1 String +1周/月 是
2 String +2周/月 是
3 String +3周/月 是
4 String +4周/月 是
5 String +5周/月 是
6 String +6周/月 是
7 String +7周/月 是
8 String +8周/月 是
id String 序号 是

返回数据JSON实例：

成功返回： 

{

“flag”: 2,

“queryResult”: [

{

"id":"1",

"startdate": "2012-01-01",

"enddate": "2012-01-01",

"newusers": 232,

"1": "1%",

"2": "3%",

"3": "34%"，

"4": "34%"，

"5": "34%"，

"6": "34%"，

"7": "34%"，

"8": "34%"

},

{

"id":"2",

"startdate": "2012-01-01",

"enddate": "2012-01-01",

"newusers": 232,

"1": "1%",

"2": "3%",

"3": "34%",

"4": "34%",

"5": "34%",

"6": "34%",

"7": "34%",

"8": "34%"

}

]

}

1.17 获取终端名称数据

getdevicebrand

1.17.1 功能说明

根据productid获取时间段内前N(由limit决定)位终端设备名称数据分布。

1.17.2 调用说明

1.17.2.1 请求方式

post

1.17.2.2 请求地址

PREURL/api/getdevicebrand

1.17.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日日期
limit String Top N 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“limit”:”10″

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.17.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
newusers JSONArray 新用户数 是
activeusers JSONArray 活跃用户数 是
num String 使用次数 是
brand String 设备名称 是
id String 序号，倒排 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"newusers": [

{

"id": "1",

"name": "HTC Desire",

"num": 100

},

{

"id": "2",

"name": "HTC WildFire",

"num": 23

},

{

"id": "3",

"name": "Samsung T1000"

"num": 32

}

],

“activeusers”: [

{

"id": "1",

"name": "Samsung T100"

"num": 343

},

{

"id": "2",

"name": "HTC G8"

"num": 22

},

{

"id": "3",

"name": "HTC G10"

"num": 1

}

]

}


]

}

1.18 获取终端操作系统数据

getdeviceosversion

1.18.1 功能说明

根据productid获取时间段内前N(由limit决定)位终端操作系统数据分布。

1.18.2 调用说明

1.18.2.1 请求方式

post

1.18.2.2 请求地址

PREURL/api/getdeviceosversion

1.18.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
limit String Top N，此项省缺为所有数据 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“limit”:”10″

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.18.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
newusers JSONArray 新用户数 是
activeusers JSONArray 活跃用户数 是
num String 使用次数 是
osversion String 设备操作系统 是
id String 序号，倒排 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"newusers": [

{

"id": "1",

"osversion": "4.0",

"num": 100

},

{

"id": "2",

"osversion": "4.1",

"num": 23

},

{

"id": "3",

"osversion": "4.1.1",

"num": 32

}

],

“activeusers”: [

{

"id": "1",

"osversion": "4.1.1"

"num": 343

},

{

"id": "2",

"osversion": "4.1",

"num": 22

},

{

"id": "3",

"osversion": "4.0",

"num": 1

}

]

}

]

}

1.19 获取终端分辨率数据

getdeviceresolution

1.19.1 功能说明

根据productid获取时间段内前N(由limit决定)位终端操作系统分辨率数据分布。

1.19.2 调用说明

1.19.2.1 请求方式

post

1.19.2.2 请求地址

PREURL/api/getdeviceresolution

1.19.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
limit String Top N，此项省缺为所有数据 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“limit”:”10″

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.19.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
newusers JSONArray 新用户数 是
activeusers JSONArray 活跃用户数 是
num String 使用次数 是
resolution String 操作系统分辨率 是
idString 序号，倒排 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"newusers": [

{

"id": "1",

"resolution": "1280*800",

"num": 100

},

{

"id": "2",

"resolution": "480*800",

"num": 23

},

{

"id": "3",

"resolution": "480*820"

"num": 32

}

],

“activeusers”: [

{

"id": "1",

"resolution": "480*820"

"num": 343

},

{

"id": "2",

"resolution": "960*1024"

"num": 22

},

{

"id": "3",

"resolution": "320*480"

"num": 1

}

]

}

]

}

1.20 获取终端运营商数据

getdevicecarrier

1.20.1 功能说明

根据productid获取时间段内前N(由limit决定)位终端使用运营商数据分布。

1.20.2 调用说明

1.20.2.1 请求方式

post

1.20.2.2 请求地址

PREURL/api/getdevicecarrier

1.20.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
limit String Top N，此项省缺为所有数据 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“limit”:”10″

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.20.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
newusers JSONArray 新用户数 是
activeusers JSONArray 活跃用户数 是
num String 使用次数 是
carrier String 运营商 是
id String 序号，倒排 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"newusers": [

{

"id": "1",

"carrier": "中国移动",

"num": 100

},

{

"id": "2",

"carrier": "中国联通",

"num": 23

},

{

"id": "3",

"carrier": "中国电信"

"num": 32

}

],

“activeusers”: [

{

"id": "1",

"carrier": "中国电信"

"num": 343

},

{

"id": "2",

"carrier": "中国联通"

"num": 22

},

{

"id": "3",

"carrier": "中国移动"

"num": 1

}

]

}

]

}

1.21 获取终端联网方式数据

getdevicenetwork

1.21.1 功能说明

根据productid获取时间段内前N(由limit决定)位终端联网方式的数据分布。

1.21.2 调用说明

1.21.2.1 请求方式

post

1.21.2.2 请求地址

PREURL/api/getdevicenetwork

1.21.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
limit String Top N，此项省缺为所有数据 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“limit”:”10″

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.21.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
newusers JSONArray 新用户数 是
activeusers JSONArray 活跃用户数 是
num String 使用次数 是
network String 联网方式 是
id String 序号，倒排 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"newusers": [

{

"id": "1",

"network": "WIFI",

"num": 100

},

{

"id": "2",

"network": "GPRS",

"num": 23

},

{

"id": "3",

"network": "3G"

"num": 32

}

],

“activeusers”: [

{

"id": "1",

"network": "WIFI",

"num": 343

},

{

"id": "2",

"network": "3G",

"num": 22

},

{

"id": "3",

"network": "GPRS",

"num": 1

}

]

}

]

}

1.22 获取事件数据

geteventdata

1.22.1 功能说明

根据productid获取时间段内事件的详细数据。

1.22.2 调用说明

1.22.2.1 请求方式

post

1.22.2.2 请求地址

PREURL/api/geteventdata

1.22.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
version String 版本，省缺为所有版本 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“version”:”1.0″

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.22.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
eventid JSONArray 事件ID 是
eventname JSONArray 事件名称 是
num String 事件发生次数 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"eventid": "1",

"eventname": "clickbutton",

"num": 100

},

{

"eventid": "2",

"eventname": "payment",

"num": 23

},

{

"eventid": "3",

"eventname": "help",

"num": 23

}

]

}

1.23 获取单一事件详细数据

geteventdetail

1.23.1 功能说明

根据productid获取时间段内的某事件的数量等。

1.23.2 调用说明

1.23.2.1 请求方式

post

1.23.2.2 请求地址

PREURL/api/geteventdetail

1.23.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
eventid String 事件ID 是
startdate String 开始日期 是
enddate String 结束日期 是
version String 版本，缺省为所有版本 否

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“eventid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“version”:”1.0″

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“eventid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.23.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
id String 序号 是
datevalue String 日期 是
num String 事件发生次数 是

返回数据JSON实例：

成功返回： </code> {

“flag”: “3″,

“queryResult”: [

{

“id”: “1”,

“datevalue”: “2013-4-1”,

“num”: 100

},

{

“id”: “2”,

“datevalue”: “2013-4-2”,

“num”: 100

},

{

“id”: “3”,

“datevalue”: “2013-4-3”,

“num”: 100

},

]

}</code>

1.24 获取转化率列表

getconversionlist

1.24.1 功能说明

根据productid获取某时间段内事件的转化率列表数据。

1.24.2 调用说明

1.24.2.1 请求方式

post

1.24.2.2 请求地址

PREURL/api/getconversionlist

1.24.3 参数

字段名称 数据类型 描述 是否必须

sessionkey |String |登录成功后返回的验证key |是|

productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

}

1.24.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
targetid String 目标ID 是
targetname String 目标名称 是
price String 目标价值 是
startevent String 起始事件 是
endevent String 结束时间 是
conversion String 转化率 是

返回数据JSON实例：

成功返回： 

{

“flag”: “3″,

“queryResult”: [

{

"targetid": "1",

"targetname": "1",

"price": "2013-4-1",

"startevent": "menu_exit",

"endevent": "menu_login",

"conversion": 0.87

},

{

"targetid": "2",

"targetname": "1",

"price": "2013-4-1",

"startevent": "menu_exit",

"endevent": "click",

"conversion": 0.87

},

{

"targetid": "3",

"targetname": "1",

"price": "2013-4-1",

"startevent": "menu_exit",

"endevent": "click",

"conversion": 0.87

}

]

}

1.25 获取转化率详细信息

getconversiondetail

1.25.1 功能说明

根据productid获取某时间段内转化率的详细信息数据。

1.25.2 调用说明

1.25.2.1 请求方式

post

1.25.2.2 请求地址

PREURL/api/getconversiondetail

1.25.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后返回的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
targetid String 目标ID 是
version String 版本，缺省为所有版本 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“targetid”: “1″,

}

或

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“targetid”: “1″,

“version”: “0.1″,

}

1.25.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
id String 序号 是
eventid String 目标ID 是
eventname String 目标名称 是
num String 目标价值 是
conversion String 转化率 是

返回数据JSON实例：

成功返回： 

{

“flag”: “3″,

“queryResult”: [

{

"id":"1",

"eventid": "click",

"eventname": "click事件",

"num": "100",

"conversion": 0.87

},

{

"id":"2",

"eventid": "exit",

"eventname": "退出",

"num": "20",

"conversion": 0.87

},

{

"id":"3",

"eventid": "quit",

"eventname": "退出",

"num": "23",

"conversion": 0.87

},

]

}

1.26 获取错误信息（按版本）

geterrorbyversion

1.26.1 功能说明

根据productid获取时间段内的各版本的错误数量等。

1.26.2 调用说明

1.26.2.1 调用方式

post

1.26.2.2 调用地址

PREURL/api/geterrorbyversion

1.26.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}<code>

==== 1.26.4    返回结果 ====
^字段名称 ^数据类型 ^描述 ^是否必须^
|flag |int     |标识，>0成功，<0失败	 |是|
|queryResult |JSONArray | |是|
|version |String            | 日期	 |是|
|num |String |错误数量 |是|

返回数据JSON实例：

成功返回：
<code>
{

“flag”: “2″,

“queryResult”: [

{

"version":"0.1",

"num": "100"

},

{

"version":"0.2",

"num": "100"

}

]

}<code>

===== 1.27    获取错误详细信息（按版本） =====


geterrordetailbyversion

==== 1.27.1    功能说明 ====



根据productid获取时间段内的各版本的错误详细数据量等。

==== 1.27.2    调用说明 ====


=== 1.27.2.1    调用方式 ===


post

=== 1.27.2.2    调用地址 ===


PREURL/api/geterrordetailbyversion

==== 1.27.3    参数 ====
^字段名称 ^数据类型 ^描述 ^是否必须^
|sessionkey |String |登录成功后的验证key |是|
|productid |String |产品ID |是|
|startdate |String       | 开始日期	 |是|
|enddate |String |结束日期 |是|
发送数据JSON实例：
<code>
{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.27.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
errorid String 错误ID 是
errortitle String 错误名称 是
version String 版本 是
lastdate String 最近发生日期 是
num String 错误数量 是
isfix String 是否修复 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"errorid":"1",

"errortitle":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"version":"0.1",

"lastdate":"2013-3-1",

"num": "10",

"isfix": "true",

},

{

"errorid":"2",

"errortitle":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"version":"0.3",

"lastdate":"2013-3-1",

"num": "103",

"isfix": "false",

},

]

}

1.28 获取错误详细列表（按版本）

geterrordetaillistbyversion

1.28.1 功能说明

根据productid获取时间段内的各版本的某一类型错误的所有错误记录。

1.28.2 调用说明

1.28.2.1 调用方式

post

1.28.2.2 调用地址

PREURL/api/geterrordetailbyversion

1.28.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
erroridentifier String MD5加密后 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“erroridentifier”:”AB876C09F98″

}

1.28.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
datetime String 最近发生日日期 是
osversion String 版本 是
device String 设备 是
stacktrace String 错误详细 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"stacktrace":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"osversion":"5.0",

"datetime":"2013-3-1 23:00:00",

"device": "HTC Desire"

},

{

"stacktrace":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at      android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"osversion":"5.1",

"datetime":"2013-3-1 22:22:00",

"device": "HTC Desire"

}

]

}

1.29 获取错误在操作系统和设备的分布情况（按版本）

geterrordistributionbyversion

1.29.1 功能说明

根据productid获取时间段内的各版本的某一类型错误的所有错误记录。

1.29.2 调用说明

1.29.2.1 调用方式

post

1.29.2.2 调用地址

PREURL/api/geterrordistributionbyversion

1.29.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
erroridentifier String MD5加密后 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“erroridentifier”:”AB876C09F98″

}

1.29.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
osversiondis JSONArray 是
devicedis JSONArray 是
osversion String 操作系统版本
device String 设备 是
num String 错误数量 是

返回数据JSON实例：

成功返回： 

{

“flag”: “1″,

“queryResult”: [

{

"osversiondis": [

{

"osversion": "5.0",

"num": "98"

},

{

"osversion": "5.0",

"num": "98"

}

],

“devicedis”: [

{

"device": "HTC Desire",

"num": "32"

},

{

"device": "HTC Desire",

"num": "32"

}

]

}

]

}

1.30 获取错误信息（按操作系统版本）

geterrorbyosversion

1.30.1 功能说明

根据productid获取时间段内的各操作系统版本的错误数量等。

1.30.2 调用说明

1.30.2.1 调用方式

post

1.30.2.2 调用地址

PREURL/api/geterrorbyosversion

1.30.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.30.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
osversion String 操作系统版本 是
num String 错误数量 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"osversion":"4.0",

"num": "100"

},

{

"osversion":"5.0",

"num": "100"

}

]

}

1.31 获取错误详细信息（按操作系统版本）

geterrordetailbyosversion

1.31.1 功能说

明

根据productid获取时间段内的各操作系统版本的错误详细数量等。

1.31.2 调用说明

1.31.2.1 调用方式

post

1.31.2.2 调用地址

PREURL/api/geterrordetailbyosversion

1.31.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.31.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
errorid String 错误ID 是
errortitle String 错误标题 是
osversion String 操作系统版本 是
lastdate String 最近发生日期 是
num String 错误数量 是
isfix String 是否修复 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"errorid":"1",

"errortitle":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"osversion":"5.0",

"lastdate":"2013-3-1",

"num": "10",

"isfix": "true",

},

{

"errorid":"2",

"errortitle":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"osversion":"5.1",

"lastdate":"2013-3-1",

"num": "103",

"isfix": "false",

}

]

}

1.32 获取错误详细列表（按操作系统版本）

geterrordetaillistbyosversion

1.32.1 功能说明

根据productid获取时间段内的各版本的某一类型错误的所有错误记录。

1.32.2 调用说明

1.32.2.1 调用方式

post

1.32.2.2 调用地址

PREURL/api/geterrordetaillistbyosversion

1.32.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
erroridentifier String MD5加密后 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“erroridentifier”:”AB876C09F98″

}

1.32.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
datetime String 最近发生日期 是
version String 版本 是
device String设备 是
stacktrace String 错误详细 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"stacktrace":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"version":"0.1",

"datetime":"2013-3-1 23:00:00",

"device": "HTC Desire"

},

{

"stacktrace":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"version":"0.1",

"datetime":"2013-3-1 22:22:00",

"device": "HTC Desire"

}

]

}

1.33 获取错误在版本和设备的分布情况（按操作系统版本）

geterrordistributionbyversion

1.33.1 功能说明

根据productid获取时间段内的各操作系统版本的某一类型错误的所有错误记录。

1.33.2 调用说明

1.33.2.1 调用方式

post

1.33.2.2 调用地址

PREURL/api/geterrordistributionbyversion

1.33.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
erroridentifier String MD5加密后 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“erroridentifier”:”AB876C09F98″

}

1.33.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
versiondis JSONArray 是
devicedis JSONArray 是
version String 版本 是
device String 设备 是
num String 错误数量

返回数据JSON实例：

成功返回： 

{

“flag”: “1″,

“queryResult”: [

{

"versiondis": [

{

"version": "0.1",

"num": "98"

},

{

"version": "0.2",

"num": "98"

}

],

“devicedis”: [

{

"device": "HTC Desire",

"num": "32"

},

{

"device": "HTC Desire",

"num": "32"

}

]

}

]

}

1.34 获取错误信息（按设备）

geterrorbydevice

1.34.1 功能说明

根据productid获取时间段内的各版本的错误数量等。

1.34.2 调用说明

1.34.2.1 调用方

式

post

1.34.2.2 调用地址

PREURL/api/geterrorbydevice

1.34.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.34.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
device String 设备名称 是
num String 错误数量

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"device":"HTC Desire",

"num": "100"

},

{

"device":"Samsung T9100",

"num": "100"

}

]

}

1.35 获取错误详细信息（按设备）

geterrordetailbydevice

1.35.1 功能说明

根据productid获取时间段内的各版本的错误详细数量等。

1.35.2 调用说明

1.35.2.1 调用方式

post

1.35.2.2 调用地址

PREURL/api/geterrordetailbydevice

1.35.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″

}

1.35.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
errorid String 错误ID 是
errortitle String 错误标题 是
device String 设备名称 是
lastdate String 最近发生日期 是
num String 错误数量 是
isfix String 是否修复 是

返回数据JSON实例：

成功返回： 

{

“flag”: “2″,

“queryResult”: [

{

"errorid":"1",

"errortitle":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"device":"HTC Desire",

"lastdate":"2013-3-1",

"num": "10",

"isfix": "true"

},

{

"errorid":"2",

"errortitle":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"device":"Samsung T9100",

"lastdate":"2013-3-1",

"isfix": "false"

},

]

}

1.36 获取错误详细列表（按设备）

geterrordetaillistbydevice

1.36.1 功能说明

根据productid获取时间段内的各版本的某一类型错误的所有错误记录。

1.36.2 调用说明

1.36.2.1 调用方式

post

1.36.2.2 调用地址

PREURL/api/geterrordetaillistbydevice

1.36.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
erroridentifier String MD5加密后 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“erroridentifier”:”AB876C09F98″

}<code>

==== 1.36.4    返回结果 ====

^字段名称 ^数据类型 ^描述 ^是否必须^
|flag |int   |  标识，>0成功，<0失败	 |是|
|queryResult |JSONArray | |是|
|datetime |String |最近发生日期 |是|
|version |String |版本 |是|
|osversion |String |操作系统版本 |是|
|stacktrace |String |错误详细 |是|
返回数据JSON实例：

成功返回：
<code>
{

“flag”: “2″,

“queryResult”: [

{

"stacktrace":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"version":"0.1",

"datetime":"2013-3-1 23:00:00",

"osversion": "5.0"

},

{

"stacktrace":"java.lang.IllegalArgumentException: Activity#onCreateDialog did not create a dialog for id 4 at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2596) at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2621)",

"version":"0.1",

"datetime":"2013-3-1 22:22:00",

"osversion": "5.1"

}

]

}

1.37 获取错误在版本和操作系版本的分布情况（按设备）

geterrordistributionbydevice

1.37.1 功能说明

根据productid获取时间段内的各版本和各操作系统版本的某一类型错误的所有错误记录数。

1.37.2 调用说明

1.37.2.1 调用方式

post

1.37.2.2 调用地址

PREURL/api/geterrordistributionbydevice

1.37.3 参数

字段名称 数据类型 描述 是否必须
sessionkey String 登录成功后的验证key 是
productid String 产品ID 是
startdate String 开始日期 是
enddate String 结束日期 是
erroridentifier String MD5加密后 是

发送数据JSON实例： 

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“startdate”: “2013-4-1″,

“enddate”: “2013-4-2″,

“erroridentifier”:”AB876C09F98″

}

1.37.4 返回结果

字段名称 数据类型 描述 是否必须
flag int 标识，>0成功，<0失败 是
queryResult JSONArray 是
versiondistribution JSONArray 是
osversiondistribution JSONArray 是
version String 版本 是
osversion String 操作系统版本 是
num 错误数量 是

返回数据JSON实例：

成功返回： 

{

“flag”: “1″,

“queryResult”: [

{

"versiondistribution": [

{

"version": "0.1",

"num": "98"

},

{

"version": "0.2",

"num": "98"

}

],

“osversiondistribution”: [

{

"osversion": "5.0",

"num": "32"

},

{

"osversion": "5.1",

"num": "32"

}

]

}

]

}
razor/cobub-razor-api-manual.1441952398.txt.gz · 最后更改: 2017/07/14 11:12 (外部编辑)

页面工具

© Copyright 2012 - 2015 南京西桥科技有限公司 Western Bridge Tech Co., Ltd.
苏ICP备13039116号-1