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：

Success:

{

“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 Get active rate in the latest week/month

getactiveratio

1.8.1 Functional specifications

According to the productid get activeusers and active rate in the latest week/month.

1.8.2 Call instruction

1.8.2.1 The request method

post

1.8.2.2 Address of the request

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	weekly active users	YES
musers	String	monthly active users	YES
wuserpercent	String	weekly user percent	YES
muserpercent	String	monthly user percent	YES

Returns a JSON data instance：

Success:

{

“flag”: “1″,

“wusers”: “100″,

“musers”: “1029″,

“wuserpercent”: “0.31″,

“muserpercent”: “0.32″

}

1.9 For each version this week/this month active rate

getchannelactiveratio

1.9.1 Functional specifications

According to the productid get activeusers and active rate in the latest week/month.

1.9.2 Call instruction

1.9.2.1 The request method

post

1.9.2.2 Address of the request

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	weekly active users/monthly active users
rate	String	Weekly rate of active/Monthly rate of active	YES
channelid	String	Channel ID	YES

Returns a JSON data instance：

Success:

{

“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 Get frequency

getfrequency

1.10.1 Functional specifications

According to the use frequency productid for period of time.

1.10.2 Call instruction

1.10.2.1 The request method

post

1.10.2.2 Address of the request

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	The frequency distribution id	YES
segment_name	String	Name of the frequency distribution	YES
access	String	visits	YES
percentage	String	The percentage	YES

Returns a JSON data instance：

Success:

{

“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 Obtain usingtime data

getusingtime

1.11.1 Functional specifications

According to the productid get usingtime distribution period.

1.11.2 Call instruction

1.11.2.1 The request method

post

1.11.2.2 Address of the request

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	The frequency distribution id	YES
segment_name	String	Name of the frequency distribution	YES
numbers	String	times	YES
percentage	String	proportion	YES

Returns a JSON data instance： Success:

{

“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 Obtain the data per hour

getdatabyhour

1.12.1 Functional specifications

According to the productid for period of 24 hours of use.

1.12.2 Call instruction

1.12.2.1 The request method

post

1.12.2.2 Address of the request

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	The frequency distribution id	YES
segment_name	String	Name of the frequency distribution	YES
numbers	String	times	YES
percentage	String	proportion	YES

Returns a JSON data instance：

Success:

{

“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 Access to the data access page

getpagedata

1.13.1 Functional specifications

According to the productid and version get access detail page within the time period.

1.13.2 Call instruction

1.13.2.1 The request method

post

1.13.2.2 Address of the request

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	The version number, if version number is empty it means all version	NO

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“version”:”0.1″

}

OR

{

“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	page name	YES
exitcount	String	In the activity out of times	YES
count	String	count of activity	YES
duration	String	duration of activity	YES

Returns a JSON data instance：

Success:

{

“flag”: 1,

“queryResult”: [

{

"activity": "MainActivity",

"exitcount": 3,

"count": 33,

"duration": 233

},

{

"activity": "AboutActivity",

"exitcount": 3,

"count": 33,

"duration": 233

}

]

}

1.14 Obtain geographical analysis data (state)

getcountry

1.14.1 Functional specifications

According to the productid for period before access to N (determined by the limit) national distribution of the data.

1.14.2 Call instruction

1.14.2.1 The request method

post

1.14.2.2 Address of the request

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	NO

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	new users	YES
activeusers	JSONArray	active users	YES
num	String	times	YES
country	String	country name	YES
id	String	Serial number, inversion, and num is the biggest row in front	YES

Returns a JSON data instance：

Success:

{

“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 Obtain geographical analysis data (province)

getregion

1.15.1 Functional specifications

According to the productid and country (country) for periods before access to N (determined by the limit) provinces, cities and the distribution of data.

1.15.2 Call instruction

1.15.2.1 The request method

post

1.15.2.2 Address of the request

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	State the name, should be identical with getcountry output	YES
limit	String	Top N	NO

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	new users	YES
activeusers	JSONArray	active users	YES
num	String	times	YES
province	String	province name	YES
id	String	Serial number, inversion, and num is the biggest row in front	YES

Returns a JSON data instance：

Success:

{

“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 Get the user data is retained

getretention

1.16.1 Functional specifications

According to the productid get user retention period.

1.16.2 Call instruction

1.16.2.1 The request method

post

1.16.2.2 Address of the request

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	value: month or week	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“type”:”week”

}

OR

{

“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	period start date	YES
enddate	String	period end date	YES
newusers	String	new users	YES
1	String	+1week/month	YES
2	String +2week/month	YES
3	String	+3week/month	YES
4	String	+4week/month	YES
5	String	+5week/month	YES
6	String	+6week/month	YES
7	String	+7week/month	YES
8	String	+8week/month	YES
id	String	id	YES

Returns a JSON data instance：

Success:

{

“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 Data acquisition terminal name

getdevicebrand

1.17.1 Functional specifications

According to former productid acquisition period N (decided by the limit) terminal device name data distribution.

1.17.2 Call instruction

1.17.2.1 The request method

post

1.17.2.2 Address of the request

PREURL/api/getdevicebrand

1.17.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
limit	String	Top N	NO

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“limit”:”10″

}

OR

{

“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	times	YES
brand	String	devicename	YES
id	String	The serial number, inverted	YES

Returns a JSON data instance：

Success:

{

“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 Data acquisition terminal operating system

getdeviceosversion

1.18.1 Functional specifications

According to productid for time period prior to N (determined by the limit) a data distribution terminal operating system.

1.18.2 Call instruction

1.18.2.1 The request method

post

1.18.2.2 Address of the request

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，This means all data by default	NO

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“limit”:”10″

}

OR

{

“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	times	YES
osversion	String	deviceos	YES
id	String	the serial number, inverted	YES

Returns a JSON data instance：

Success:

{

“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 Data acquisition terminal resolution

getdeviceresolution

1.19.1 Functional specifications

According to productid for time period prior to N (determined by the limit) a resolution data distribution terminal operating system.

1.19.2 Call instruction

1.19.2.1 The request method

post

1.19.2.2 Address of the request

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，This means all data by default	NO

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“limit”:”10″

}

OR

{

“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	times	YES
resolution	String	os resolution	YES
id	String	id, inverted	YES

Returns a JSON data instance：

Success:

{

“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 Data acquisition terminal operators

getdevicecarrier

1.20.1 Functional specifications

According to former productid acquisition period N (decided by the limit) terminal operators using data distribution.

1.20.2 Call instruction

1.20.2.1 The request method

post

1.20.2.2 Address of the request

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，This means all data by default	NO

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“limit”:”10″

}

OR

{

“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	times	YES
carrier	String	operators	YES
id	String	the serial number, inverted	YES

Returns a JSON data instance：

Success:

{

“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 Data acquisition terminal connected to the Internet way

getdevicenetwork

1.21.1 Functional specifications

According to productid for time period prior to N (determined by the limit) a terminal connected to the way data distribution.

1.21.2 Call instruction

1.21.2.1 The request method

post

1.21.2.2 Address of the request

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，This means all data by default	NO

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“limit”:”10″

}

OR

{

“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	times	YES
network	String	network type	YES
id	String	the serial number, inverted	YES

Returns a JSON data instance：

Success:

{

“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 Access the event data

geteventdata

1.22.1 Functional specifications

Based on detailed data productid for event period.

1.22.2 Call instruction

1.22.2.1 The request method

post

1.22.2.2 Address of the request

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	version，The default for all versions	NO

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	event id	YES
eventname	JSONArray	event name	YES
num	String	number	YES

Returns a JSON data instance：

Success:

{

“flag”: “2″,

“queryResult”: [

{

"eventid": "1",

"eventname": "clickbutton",

"num": 100

},

{

"eventid": "2",

"eventname": "payment",

"num": 23

},

{

"eventid": "3",

"eventname": "help",

"num": 23

}

]

}

1.23 Detailed data for a single event

geteventdetail

1.23.1 Functional specifications

According to the productid for period of time the number of a certain event, etc.

1.23.2 Call instruction

1.23.2.1 The request method

post

1.23.2.2 Address of the request

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	event id	YES
startdate	String	start date	YES
enddate	String	end date	YES
version	String	version，缺省为所有version	NO

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

“eventid”: “1″,

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

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

“version”:”1.0″

}

OR

{

“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	id	YES
datevalue	String	date	YES
num	String	number	YES

Returns a JSON data instance：

Success: </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 Get the conversion list

getconversionlist

1.24.1 Functional specifications

According to the productid list of conversion data for a certain time period events.

1.24.2 Call instruction

1.24.2.1 The request method

post

1.24.2.2 Address of the request

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	target ID	YES
targetname	String	target name	YES
price	String	target value	YES
startevent	String	Initial events	YES
endevent	String	end time	YES
conversion	String	Conversion rate	YES

Returns a JSON data instance：

Success:

{

“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 Conversion in detail information

getconversiondetail

1.25.1 Functional specifications

According to the productid detailed information for a certain time period conversion data.

1.25.2 Call instruction

1.25.2.1 The request method

post

1.25.2.2 Address of the request

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	target ID	YES
version	String	version，The default for all versions	YES

Sending JSON data instance：

{

“sessionkey”:”1341423432423″,

“productid”: “1″,

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

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

“targetid”: “1″,

}

OR

{

“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	id	YES
eventid	String	target ID	YES
eventname	String	target name	YES
num	String	target value	YES
conversion	String	conversion rate	YES

Returns a JSON data instance：

Success:

{

“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 Get error message (press release)

geterrorbyversion

1.26.1 Functional specifications

According to the productid time period for each version of the number of errors, etc.

1.26.2 Call instruction

1.26.2.1 The request method

post

1.26.2.2 Address of request

PREURL/api/geterrorbyversion

1.26.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″

}<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 |number |YES|

Returns a JSON data instance：

Success:
<code>
{

“flag”: “2″,

“queryResult”: [

{

"version":"0.1",

"num": "100"

},

{

"version":"0.2",

"num": "100"

}

]

}<code>

===== 1.27    Error detailed information (press release) =====


geterrordetailbyversion

==== 1.27.1    Functional specifications ====



According to the productid time period for each version of the wrong amount of detailed data, etc.

==== 1.27.2    Call instruction ====


=== 1.27.2.1    The request method ===


post

=== 1.27.2.2    Address of request ===


PREURL/api/geterrordetailbyversion

==== 1.27.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：
<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	error ID	YES
errortitle	String	error name	YES
version	String	version	YES
lastdate	String	recent date	YES
num	String	error number	YES
isfix	String	is fixed?	YES

Returns a JSON data instance：

Success:

{

“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 Access error detailed list (press release)

geterrordetaillistbyversion

1.28.1 Functional specifications

According to the productid for period of time of each version of a type error record all errors.

1.28.2 Call instruction

1.28.2.1 The request method

post

1.28.2.2 Address of request

PREURL/api/geterrordetailbyversion

1.28.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
erroridentifier	String	MD5 encrypted	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	recent date	YES
osversion	String	version	YES
device	String	device	YES
stacktrace	String	stack trace	YES

Returns a JSON data instance：

Success:

{

“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 Get error in the distribution of operating systems and devices (press release)

geterrordistributionbyversion

1.29.1 Functional specifications

According to the productid for period of time of each version of a type error record all errors.

1.29.2 Call instruction

1.29.2.1 The request method

post

1.29.2.2 Address of request

PREURL/api/geterrordistributionbyversion

1.29.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
erroridentifier	String	MD5 encrypted	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	os version
device	String	device	YES
num	String	error number	YES

Returns a JSON data instance：

Success:

{

“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 Get error message (according to the operating system version)

geterrorbyosversion

1.30.1 Functional specifications

According to the productid for period of time the operating system version of the Error number, etc.

1.30.2 Call instruction

1.30.2.1 The request method

post

1.30.2.2 Address of request

PREURL/api/geterrorbyosversion

1.30.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.30.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
osversion	String	os version	YES
num	String	error number	YES

Returns a JSON data instance：

Success:

{

“flag”: “2″,

“queryResult”: [

{

"osversion":"4.0",

"num": "100"

},

{

"osversion":"5.0",

"num": "100"

}

]

}

1.31 Error detailed information (by OS version)

geterrordetailbyosversion

1.31.1 Functional specifications

According to the productid for period of time error detail number of each OS version.

1.31.2 Call instruction

1.31.2.1 The request method

post

1.31.2.2 Address of request

PREURL/api/geterrordetailbyosversion

1.31.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.31.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
errorid	String	error ID	YES
errortitle	String	error titile	YES
osversion	String	os version	YES
lastdate	String	recent date	YES
num	String	error number	YES
isfix	String	is fixed?	YES

Returns a JSON data instance：

Success:

{

“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 Access error detailed list (by OS version)

geterrordetaillistbyosversion

1.32.1 Functional specifications

According to the productid for period of time of each version of a type error record all errors.

1.32.2 Call instruction

1.32.2.1 The request method

post

1.32.2.2 Address of request

PREURL/api/geterrordetaillistbyosversion

1.32.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
erroridentifier	String	MD5 encrypted	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	recent date	YES
version	String	version	YES
device	String	device	YES
stacktrace	String	stack trace	YES

Returns a JSON data instance：

Success:

{

“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 To obtain the distribution of mistakes in the version and the equipment (by OS version)

geterrordistributionbyversion

1.33.1 Functional specifications

According to productid time period for the OS version of all the error record a type error.

1.33.2 Call instruction

1.33.2.1 The request method

post

1.33.2.2 Address of request

PREURL/api/geterrordistributionbyversion

1.33.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
erroridentifier	String	MD5 encrypted	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	version	YES
device	String	device	YES
num	String	error number

Returns a JSON data instance：

Success:

{

“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 Get error message (by device)

geterrorbydevice

1.34.1 Functional specifications

According to the productid time period for each version of the Error number, etc.

1.34.2 Call instruction

1.34.2.1 The request method

post

1.34.2.2 Address of request

PREURL/api/geterrorbydevice

1.34.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.34.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
device	String	devicename	YES
num	String	error number

Returns a JSON data instance：

Success:

{

“flag”: “2″,

“queryResult”: [

{

"device":"HTC Desire",

"num": "100"

},

{

"device":"Samsung T9100",

"num": "100"

}

]

}

1.35 Error detailed information (by device)

geterrordetailbydevice

1.35.1 Functional specifications

According to the productid time period for each version of the error number in detail.

1.35.2 Call instruction

1.35.2.1 The request method

post

1.35.2.2 Address of request

PREURL/api/geterrordetailbydevice

1.35.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.35.4 Result

Field name	Data type	Description	Required
flag	int	>0Success， <0fail	YES
queryResult	JSONArray		YES
errorid	String	error ID	YES
errortitle	String	error 标题	YES
device	String	devicename	YES
lastdate	String	recent date	YES
num	String	error number	YES
isfix	String	YESNO修复	YES

Returns a JSON data instance：

Success:

{

“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 Access error detailed list (by device)

geterrordetaillistbydevice

1.36.1 Functional specifications

According to the productid for period of time of each version of a type error record all errors.

1.36.2 Call instruction

1.36.2.1 The request method

post

1.36.2.2 Address of request

PREURL/api/geterrordetaillistbydevice

1.36.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
erroridentifier	String	MD5 encrypted	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 |recent date |YES|
|version |String |version |YES|
|osversion |String |os version |YES|
|stacktrace |String |stack trace |YES|
Returns a JSON data instance：

Success:
<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 Error in the version and operating system version of the distribution (by device)

geterrordistributionbydevice

1.37.1 Functional specifications

According to productid time period for each version and OS version number one all of the wrong type of error.

1.37.2 Call instruction

1.37.2.1 The request method

post

1.37.2.2 Address of request

PREURL/api/geterrordistributionbydevice

1.37.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
erroridentifier	String	MD5 encrypted	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 Get active rate in the latest week/month

1.8.1 Functional specifications

1.8.2 Call instruction

1.8.2.1 The request method

1.8.2.2 Address of the request

1.8.3 Parameters

1.8.4 Result

1.9 For each version this week/this month active rate

1.9.1 Functional specifications

1.9.2 Call instruction

1.9.2.1 The request method

1.9.2.2 Address of the request

1.9.3 Parameters

1.9.4 Result

1.10 Get frequency

1.10.1 Functional specifications

1.10.2 Call instruction

1.10.2.1 The request method

1.10.2.2 Address of the request

1.10.3 Parameters

1.10.4 Result

1.11 Obtain usingtime data

1.11.1 Functional specifications

1.11.2 Call instruction