这是本文档旧的修订版！

Cobub Razor API Manual

1 API List

Interface	Description
login	User login validation
getproductlist	To obtain a list of accessible applications
getversionlist	To obtain a list all versions
getchannellist	get all the channel list
getbasicdata	To obtain basic data
getbasicdatabychannel	To obtain basic data( by channel)
getbasicdatabyversion	To obtain basic data( by version)
getactiveratio	Get active rate in the latest week/month
getchannelactiveratio	For each version this week/this month’s rate of active users and active
getfrequency	Access to frequently used data
getusingtime	Access to use length data
getdatabyhour	Get data by hour
getpagedata	Obtain the data of page access
getcountry	Obtain geographical analysis data (state)
getregion	Obtain geographical analysis data (province)
getretention	Get the user data is retained
getdevicebrand	Data acquisition terminal name
getdeviceosversion	Data acquisition terminal operating system version
getdeviceresolution	Data acquisition terminal resolution
getdevicecarrier	Data acquisition terminal operators
getdevicenetwork	Data acquisition terminal connected to the Internet way
geteventdata	Access the event data
geteventdetail	Detailed data for a single event
getconversionlist	For the conversion list
getconversiondetail	Conversion in detail information
geterrorbyversion	Get error message (by version)
geterrordetailbyversion	Get error detailed information(by version)
geterrordetaillistbyversion	Access error detailed list (by version)
geterrordistributionbyversion	Get error in the distribution of operating systems and devices (by version)
geterrorbyosversion	Get error message(by os version)
geterrordetailbyosversion	Get error detail infomation( by os version)
geterrordetaillistbyosversion	Access error detailed list (by os version)
geterrordistributionbyversion	To obtain the distribution of mistakes in the version and the equipment (by os version)
geterrorbydevice	Get error message (by device)
geterrordetailbydevice	Get error detail information (by device)
geterrordetaillistbydevice	Access error detailed list(by device)
geterrordistributionbydevice	Mistakes in the version and operating system version of the distribution(by device)

All OpenAPI based on HTTP and JSON, please make sure that JSON string in POST body with a content= prefix, like this:

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

1.1 User authentication

login

1.1.1 Functional specifications

User login validation.

1.1.2 Call instructions

1.1.2.1 The request method

post

1.1.2.2 Address of the request

PREURL/api/login (PREURL is the prefix of Cobub Razor website, such as http://localhost/ums/index.php?, same as below)

1.1.3 parameters

The field names	Data types	Description	Mandatory
username	String	cobub username	yes
password	String	The md5 encrypted password	yes

Sending JSON data instance：

{

“username”:”admin”,

“password”:”765E5A00B76FF4ECA098BB”

}

1.1.4 result

The field names	Data types	Description	Mandatory
flag	String	>0 success，<0 failure	yes
msg	String	Prompt information	yes
sessionkey	String	Parameters when API calls	yes

Returns a JSON data instance：

Success：

{

“flag”:”1″,

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

“sessionkey”:”A7E76DD709C0B1A”

}

Failure：

{

“flag”:”-1″,

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

}

Error types：

Flag	Msg	Description
-1	username not exists	username not exists
-2	invalid password	invalid password
-3	too many login attempts	too many login attempts
-4	DB Error	Database Error

1.2 To obtain a list of accessible applications

getproductlist

1.2.1 Functional specifications

To obtain a list of accessible applications.

1.2.2 Call instructions

1.2.2.1 The request method

post

1.2.2.2 Address of the request

PREURL/api/getproductlist

1.2.3 parameters

The field names	Data types	Description	Required
sessionkey	String	the key after a successful login to validation	yes

Sending JSON data instance：

{

“sessionkey”: “765E5A00B76FF4ECA098BB”

}

1.2.4 result

The field names	Data types	Description	Required
flag	String	>0Success，The size of queryresult， <0fail	yes
msg	String	Prompt information	yes
sessionkey	String	Parameters when API calls	yes

Returns a JSON data instance：

Success：

{

“flag”: “2″,

“queryresult”: [

{

"platform": "iOS",

"productid": "1",

"productname": "name1"

},

{

"platform": "Android",

"productid": "2",

"productname": "name2"

}

]

}

fail：

{

“flag”:”-1″,

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

}

Error type definition：

Flag	Msg	说明
-1	JSON format is not correct	JSON format is not correct
-2	Sessionkey is invalide	Sessionkey is invalide
-3	DB Error	Database error
-4	Network error	Network error

1.3 To obtain a list all versions

getversionlist

1.3.1 Functional specifications

According to the productid get all the version information of the product

1.3.2 Call instructions

1.3.2.1 The request method

post

1.3.2.2 Address of the request

PREURL/api/getversionlist

1.3.3 Parameters

Field name	Data type	Description	Required
sessionkey	String	A key to validation after the login success	yes
productid	String	productid	yes

Sending JSON data instance：

{

“sessionkey”: “765E5A00B76FF4ECA098BB”,

“productid”:”1″

}

1.3.4 Results

Field name	Data type	Description	Required
flag	String	>0Success，The size of queryresult	yes
msg	String	Prompt information	yes
queryresult	JSONArray	Version List	no
version	String	version name	yes

Returns a JSON data instance：

Success：

{

“flag”: “2″,

“queryResult”: [

{

"version": "0.1"

},

{

"version": "0.2"

}

]

}

fail：

{

“flag”:”-1″,

“msg”:”格式不正确”

}

Error type ：

Flag	Msg	Description
-1	JSON format is not correct	JSON format is not correct
-2	Sessionkey is invalid	Sessionkey is invalid
-3	DB Error	Database Error
-4	Network error	Network error

1.4 Get all the channel list

getchannellist

1.4.1 Functional specifications

According to the productid get all the channel information of the product

1.4.2 Call instructions

1.4.2.1 The request method

post

1.4.2.2 Address of the request

PREURL/api/getchannellist

1.4.3 parameters

Field name	Data type	Description	Required
sessionkey	String	A key to validation after the login success	yes
productid	String	productid	yes

Sending JSON data instance：

{

“sessionkey”: “765E5A00B76FF4ECA098BB”,

“productid”:”1″

}

1.4.4 Result

Field name	Data type	Description	Required
flag	String	>0Success，The size of queryresult	yes
msg	String	Prompt info	yes
queryresult	JSONArray	Version列表	no
id	String	channel ID	yes
name	String	channel Name	yes

Returns a JSON data instance：

Success：

{

“flag”: “2″,

“queryResult”: [

{

"id": "1",

"name":"机锋市场"

},

{

"id": "2",

"name":"安卓市场"

}

]

}

Success：

{

“flag”: “0″,

“queryResult”:””

}

fail：

{

“flag”:”-1″,

“msg”:”格式不正确”

}

Error type:

Flag	Msg	Description
-1	JSON format is not correct	JSON format is not correct
-2	Sessionkey is invalide	Sessionkey is invalide
-3	DB Error	Database Error
-4	Network error	Network error

1.5 To obtain basic data

getbasicdata

1.5.1 Functional specifications

According to the productid start times access to the product within a certain period of time, new users, active users, and average use time, upgrade user, user.

1.5.2 Call instructions

1.5.2.1 The request method

post

1.5.2.2 Address of the request

PREURL/api/getbasicdata

1.5.3 Parameters

Field name	Data type	Description	Required
sessionkey	String	A key to validation after the login success	yes
productid	String	Product ID	yes
startdate	String	start date	yes
enddate	String	end date	yes

Sending JSON data instance：

{

“sessionkey”: “765E5A00B76FF4ECA098BB”,

“productid”:”1″,

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

“enddate”:”2013-1-2″

}

1.5.4 result

Field name	Data type	Description	Required
flag	int	>0Success，The size of queryresult，	yes
msg	String	Prompt information	yes
queryresult	JSONArray	Version list	no
date	String	date	yes
sessions	String	session	yes
activeusers	String	active user	yes
newusers	String	new user	yes
usingtime	String	using time	yes
allusers	String	all users	yes
upgradeusers	String	upgradeusers	yes

Returns a JSON data instance：

Success：

{

“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

}

]

}

error：

{

“flag”:”-1″,

“msg”:”格式不正确”

}

Error type:

Flag	Msg	Description
-1	JSON format is not correct	JSON format is not correct
-2	Sessionkey is invalide	Sessionkey is invalide
-3	DB Error	Database 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	操作系统分辨率	是
id	String	序号，倒排	是

返回数据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 result

Field name	Data type	Description	Required
flag	int	>0success，<0failure	y
queryResult	JSONArray		y
versiondistribution	JSONArray		y
osversiondistribution	JSONArray		y
version	String	Version	y
osversion	String	OS version	y
num	# error		y

Returns a JSON data instance：

Success：

{

“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"

}

]

}

]

}

Cobub文档中心

用户工具

站点工具

侧边栏

目录

Cobub Razor API Manual

1 API List

1.1 User authentication

1.1.1 Functional specifications

1.1.2 Call instructions

1.1.2.1 The request method

1.1.2.2 Address of the request

1.1.3 parameters

1.1.4 result

1.2 To obtain a list of accessible applications

1.2.1 Functional specifications

1.2.2 Call instructions

1.2.2.1 The request method

1.2.2.2 Address of the request

1.2.3 parameters

1.2.4 result

1.3 To obtain a list all versions

1.3.1 Functional specifications

1.3.2 Call instructions

1.3.2.1 The request method

1.3.2.2 Address of the request

1.3.3 Parameters

1.3.4 Results

1.4 Get all the channel list

1.4.1 Functional specifications

1.4.2 Call instructions

1.4.2.1 The request method

1.4.2.2 Address of the request

1.4.3 parameters

1.4.4 Result

1.5 To obtain basic data

1.5.1 Functional specifications

1.5.2 Call instructions

1.5.2.1 The request method

1.5.2.2 Address of the request

1.5.3 Parameters

1.5.4 result

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

1.6.1 功能说明

1.6.2 调用说明

1.6.2.1 请求方式

1.6.2.2 请求地址

1.6.3 参数

1.6.4 返回结果

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

1.7.1 功能说明

1.7.2 调用说明

1.7.2.1 请求方式

1.7.2.2 请求地址

1.7.3 参数

1.7.4 返回结果

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

1.8.1 功能说明

1.8.2 调用说明

1.8.2.1 请求方式

1.8.2.2 请求地址

1.8.3 参数

1.8.4 返回结果

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

1.9.1 功能说明

1.9.2 调用说明

1.9.2.1 请求方式

1.9.2.2 请求地址

1.9.3 参数

1.9.4 返回结果

1.10 获取使用频率数据

1.10.1 功能说明

1.10.2 调用说明

1.10.2.1 请求方式

1.10.2.2 请求地址

1.10.3 参数

1.10.4 返回结果

1.11 获取使用时长数据

1.11.1 功能说明

1.11.2 调用说明