目录

This document is valid for Version 0.7 of Cobub Razor.

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 ErrorDatabase 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 successyes
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
versionString version nameyes

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 successy
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
idString 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 successYES
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 Stringdevice 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"

}

]

}

]

}