这是本文档旧的修订版！

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 To obtain basic data (by channel)

getbasicdatabychannel

1.6.1 Functional specifications

According to the productid start times of all channels under the specified time period, the new users, active users, and average use time, cumulative users, cumulative startup times.

1.6.2 Call instructions

1.6.2.1 The request method

post

1.6.2.2 Address of the request

PREURL/api/getbasicdatabychannel

1.6.3 parameters

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

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

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

“productid”: “123″,

“startdate”: “2013-4-1

}

1.6.4 result

Field name	Data type	Description	Required
flag	int	>0Success，The size of queryresult <0fail	y
queryResult	JSONArray	The detailed information ,the size of queryresult	y
datevalue	String	date	y
sessions	String	sessions	y
activeusers	String	activeusers	y
newusers	String	newusers	y
usingtime	String	usingtime	y
allusers	String	allusers	y
upgradeusers	String	upgradeusers	y

Returns a JSON data instance：

Success：

{

“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 To obtain basic data (by version)

getbasicdatabyversion

1.7.1 Functional specifications

According to the productid under specified period all versions of sessions, activeusers, activeusers, average usingtime, allusers, accumulated sessions.

1.7.2 Call instructions

1.7.2.1 The request method

post

1.7.2.2 Address of the request

PREURL/api/getbasicdatabyversion

1.7.3 parameter

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

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.7.4 Result

Field name	Data type	Description	Required
flag	int	标识，>0成功，且为queryResult的size<0失败	YES
queryResult	JSONArray	详细信息,queryresult为JSONArray对象flag对应值：大于等于0为queryresult数组的长度,包括version的数组	YES
datevalue	String	date	YES
activeusers	String	active users	YES
newusers	String	new users	YES
sessions	String	sessions	YES
upgradeusers	String	upgrade users	YES
allusers	String	all users	YES
allsessions	String	all sessions	YES
usingtime	String	usingtime	YES

Returns a JSON data instance：

成功返回：

{

“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获取最近一周/月的active users和活跃率。

1.8.2 调用说明

1.8.2.1 请求方式

post

1.8.2.2 请求地址

PREURL/api/getactiveratio

1.8.3 Parameters

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

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″

}

1.8.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
wusers	String	周active users	YES
musers	String	月active users	YES
wuserpercent	String	周活跃用户率	YES
muserpercent	String	月活跃用户率	YES

Returns a JSON data instance：

成功返回：

{

“flag”: “1″,

“wusers”: “100″,

“musers”: “1029″,

“wuserpercent”: “0.31″,

“muserpercent”: “0.32″

}

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

getchannelactiveratio

1.9.1 功能说明

根据productid获取最近一周/月的active users和活跃率。

1.9.2 调用说明

1.9.2.1 请求方式

post

1.9.2.2 请求地址

PREURL/api/getchannelactiveratio

1.9.3 Parameters

Field name	Data type	Description	Required
sessionkey	int	A key to validation after the login success	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES
type	String	week/month	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″，

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

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

“type”: “week”，

}

1.9.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
datevalue	String	date	YES
activeusers	String	周活跃用户/月active users
rate	String	周活跃率/月活跃率	YES
channelid	String	渠道ID	YES

Returns a JSON data instance：

成功返回：

{

“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 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”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.10.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
segment_sk	String	频率分布id	YES
segment_name	String	频率分布名称	YES
access	String	访问次数	YES
percentage	String	所占比例	YES

Returns a JSON data instance：

成功返回：

{

“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 获取usingtime数据

getusingtime

1.11.1 功能说明

根据productid获取时间段内的usingtime分布。

1.11.2 调用说明

1.11.2.1 请求方式

post

1.11.2.2 请求地址

PREURL/api/getusingtime

1.11.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”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.11.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
segment_sk	String	频率分布id	YES
segment_name	String	频率分布名称	YES
numbers	String	使用次数	YES
percentage	String	所占比例	YES

Returns a JSON data instance：成功返回：

{

“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 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”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.12.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
segment_sk	String	频率分布id	YES
segment_name	String	频率分布名称	YES
numbers	String	使用次数	YES
percentage	String	所占比例	YES

Returns a JSON data instance：

成功返回：

{

“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 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
version	String	版本号，为空时指所有版本	否

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
activity	String	页面名称	YES
exitcount	String	在activity退出次数	YES
count	String	访问activity次数	YES
duration	String	在activity中持续时长	YES

Returns a JSON data instance：

成功返回：

{

“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 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
limit	String	Top N	否

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“limit”:”10″

}

1.14.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
newusers	JSONArray	新增users	YES
activeusers	JSONArray	active users	YES
num	String	使用次数	YES
country	String	国家名称	YES
id	String	序号，倒排，num最大排在最前面	YES

Returns a JSON data instance：

成功返回：

{

“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 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
country	String	国家名称，需与getcountry输出的名称一致	YES
limit	String	Top N	否

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“country”:”China”,

“limit”:”10″

}

1.15.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
newusers	JSONArray	新增users	YES
activeusers	JSONArray	active users	YES
num	String	使用次数	YES
province	String	省市名称	YES
id	String	序号，倒排，num最大排在最前面	YES

Returns a JSON data instance：

成功返回：

{

“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 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
type	String	月:month或周:week	YES

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	String		YES
startdate	JSONArray	时间段start date	YES
enddate	String	时间段end date	YES
newusers	String	new users	YES
1	String	+1周/月	YES
2	String +2周/月	YES
3	String	+3周/月	YES
4	String	+4周/月	YES
5	String	+5周/月	YES
6	String	+6周/月	YES
7	String	+7周/月	YES
8	String	+8周/月	YES
id	String	序号	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后回的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end 日date
limit	String	Top N	否

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
newusers	JSONArray	new users	YES
activeusers	JSONArray	active users	YES
num	String	使用次数	YES
brand	String	设备名称	YES
id	String	序号，倒排	YES

Returns a JSON data instance：

成功返回：

{

“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 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
limit	String	Top N，此项省缺为所有数据	否

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
newusers	JSONArray	new users	YES
activeusers	JSONArray	active users	YES
num	String	使用次数	YES
osversion	String	设备操作系统	YES
id	String	序号，倒排	YES

Returns a JSON data instance：

成功返回：

{

“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 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
limit	String	Top N，此项省缺为所有数据	否

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
newusers	JSONArray	new users	YES
activeusers	JSONArray	active users	YES
num	String	使用次数	YES
resolution	String	操作系统分辨率	YES
id	String	序号，倒排	YES

Returns a JSON data instance：

成功返回：

{

“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 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
limit	String	Top N，此项省缺为所有数据	否

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
newusers	JSONArray	new users	YES
activeusers	JSONArray	active users	YES
num	String	使用次数	YES
carrier	String	运营商	YES
id	String	序号，倒排	YES

Returns a JSON data instance：

成功返回：

{

“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 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
limit	String	Top N，此项省缺为所有数据	否

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
newusers	JSONArray	new users	YES
activeusers	JSONArray	active users	YES
num	String	使用次数	YES
network	String	联网方式	YES
id	String	序号，倒排	YES

Returns a JSON data instance：

成功返回：

{

“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 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
version	String	版本，省缺为所有版本	否

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray	YES
eventid	JSONArray	事件ID	YES
eventname	JSONArray	事件名称	YES
num	String	事件发生次数	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	A key to validation after the login success	YES
productid	String	product id	YES
eventid	String	事件ID	YES
startdate	String	start date	YES
enddate	String	end date	YES
version	String	版本，缺省为所有版本	否

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
id	String	序号	YES
datevalue	String	date	YES
num	String	事件发生次数	YES

Returns a JSON data instance：

成功返回： </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 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”:”1341423432423″,

“productid”: “1″,

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

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

}

1.24.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
targetid	String	目标ID	YES
targetname	String	目标名称	YES
price	String	目标价值	YES
startevent	String	起始事件	YES
endevent	String	end 时间	YES
conversion	String	转化率	YES

Returns a JSON data instance：

成功返回：

{

“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 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
targetid	String	目标ID	YES
version	String	版本，缺省为所有版本	YES

Sending JSON data instance：

{

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

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
id	String	序号	YES
eventid	String	目标ID	YES
eventname	String	目标名称	YES
num	String	目标价值	YES
conversion	String	转化率	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}<code>

==== 1.26.4    Result ====
^Field name ^Data type ^Description ^Required^
|flag |int     |>0Success， <0fail	 |YES|
|queryResult |JSONArray | |YES|
|version |String            | date	 |YES|
|num |String |错误数量 |YES|

Returns a JSON data instance：

成功返回：
<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    Parameters ====
^Field name ^Data type ^Description ^Required^
|sessionkey |String |登录成功后的验证key |YES|
|productid |String |product id |YES|
|startdate |String       | start date	 |YES|
|enddate |String |end date |YES|
Sending JSON data instance：
<code>
{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.27.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
errorid	String	错误ID	YES
errortitle	String	错误名称	YES
version	String	版本	YES
lastdate	String	最近发生date	YES
num	String	错误数量	YES
isfix	String	YES否修复	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES
erroridentifier	String	MD5加密后	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“erroridentifier”:”AB876C09F98″

}

1.28.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
datetime	String	最近发生日date	YES
osversion	String	版本	YES
device	String	设备	YES
stacktrace	String	错误详细	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES
erroridentifier	String	MD5加密后	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“erroridentifier”:”AB876C09F98″

}

1.29.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
osversiondis	JSONArray		YES
devicedis	JSONArray		YES
osversion	String	操作系统版本
device	String	设备	YES
num	String	错误数量	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.30.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
osversion	String	操作系统版本	YES
num	String	错误数量	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.31.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
errorid	String	错误ID	YES
errortitle	String	错误标题	YES
osversion	String	操作系统版本	YES
lastdate	String	最近发生date	YES
num	String	错误数量	YES
isfix	String	YES否修复	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES
erroridentifier	String	MD5加密后	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“erroridentifier”:”AB876C09F98″

}

1.32.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray	YES
datetime	String	最近发生date	YES
version	String	版本	YES
device	String	设备	YES
stacktrace	String	错误详细	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES
erroridentifier	String	MD5加密后	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“erroridentifier”:”AB876C09F98″

}

1.33.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
versiondis	JSONArray		YES
devicedis	JSONArray		YES
version	String	版本	YES
device	String	设备	YES
num	String	错误数量

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.34.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
device	String	设备名称	YES
num	String	错误数量

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

“enddate”: “2013-4-2″

}

1.35.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
errorid	String	错误ID	YES
errortitle	String	错误标题	YES
device	String	设备名称	YES
lastdate	String	最近发生date	YES
num	String	错误数量	YES
isfix	String	YES否修复	YES

Returns a JSON data instance：

成功返回：

{

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

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES
erroridentifier	String	MD5加密后	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“erroridentifier”:”AB876C09F98″

}<code>

==== 1.36.4    Result ====

^Field name ^Data type ^Description ^Required^
|flag |int   |  >0Success， <0fail	 |YES|
|queryResult |JSONArray | |YES|
|datetime |String |最近发生date |YES|
|version |String |版本 |YES|
|osversion |String |操作系统版本 |YES|
|stacktrace |String |错误详细 |YES|
Returns a JSON data instance：

成功返回：
<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 Parameters

Field name	Data type	Description	Required
sessionkey	String	登录成功后的验证key	YES
productid	String	product id	YES
startdate	String	start date	YES
enddate	String	end date	YES
erroridentifier	String	MD5加密后	YES

Sending JSON data instance：

{

“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 To obtain basic data (by channel)

1.6.1 Functional specifications

1.6.2 Call instructions

1.6.2.1 The request method

1.6.2.2 Address of the request

1.6.3 parameters

1.6.4 result

1.7 To obtain basic data (by version)

1.7.1 Functional specifications

1.7.2 Call instructions

1.7.2.1 The request method

1.7.2.2 Address of the request

1.7.3 parameter

1.7.4 Result

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

1.8.1 功能说明

1.8.2 调用说明

1.8.2.1 请求方式

1.8.2.2 请求地址

1.8.3 Parameters

1.8.4 Result

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

1.9.1 功能说明

1.9.2 调用说明

1.9.2.1 请求方式

1.9.2.2 请求地址

1.9.3 Parameters

1.9.4 Result

1.10 获取使用频率数据

1.10.1 功能说明

1.10.2 调用说明

1.10.2.1 请求方式

1.10.2.2 请求地址

1.10.3 Parameters

1.10.4 Result

1.11 获取usingtime数据

1.11.1 功能说明

1.11.2 调用说明