统计云API

接口验证KEY生成规则说明

应用统计信息获取接口

应用各版本统计信息获取接口

应用地理分布统计信息获取接口

应用设备分布统计信息获取接口

应用异常错误统计信息获取接口

应用异常错误详细信息获取接口

接口验证KEY生成规则说明：

生成规则

当调用 APICloud 统计相关接口时，我们需要对头部信息中X-APICloud-AppKey 进行验证，X-APICloud-AppKey 的生成规则如下：

  1. var appKey = SHA1（应用ID + 'UZ' + 应用KEY +'UZ' + 当前时间毫秒数）+ '.' +当前时间毫秒数

例如：你的应用ID是A6968565094002，而你的应用KEY是62FB16B2-0ED6-B460-1F60-EB61954C823B，则你在请求头部信息X-APICloud-AppKey中设置的值应为 ‘A6968565094002’+’UZ’+’62FB16B2-0ED6-B460-1F60-EB61954C823B’+’UZ’+当前时间戳组合字符串后通过SHA1加密后返回字符串再加上’.当前时间毫秒数’。

示例代码如下：

  1. var now = Date.now();
  3. varappKey = sha1("A6968565094002"+"UZ"+ "62FB16B2-0ED6-B460-1F60-EB61954C823B"+"UZ"+now)+"."+now;

接口名称：应用统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内的相关应用统计数据信息。

调用地址

https://r.apicloud.com/analytics/

调用方法

getAppStatisticDataById

请求方式

POST

请求头部设置说明

  1. 相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：
  2. X-APICloud-AppId : {your app id}
  3. X-APICloud-AppKey : {you app key}

接口接收参数

  1. startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10
  2. endDate – 结束时间 格式：YYYY-MM-DD

接口返回数据

  1. 调用成功则返回相关应用统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。
  2. 接口返回状态（st） ： 1－成功 0－失败
  3. 接口返回信息（msg）：－成功为相关应用统计数据信息，失败则为错误信息。

返回数据示例

图片说明

返回字段说明

字段名称字段说明
id数据ID
appid应用ID
devicesCount设备总数
newRegsCount当天新注册用户数
newUpdateCount当天新升级用户数
activeCountInToday当天活跃用户数
activeCountInSevenDays七日内活跃用户数
activeCountInThirtyDays三十日内活跃用户数
totalUseTime应用累计使用时长
totalOperationCount应用累计使用次数
reportDate统计数据生成时间

接口名称：应用各版本统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内相关应用各版本的统计数据信息。

调用地址

https://r.apicloud.com/analytics/

调用方法

getVersionsStatisticDataById

请求方式

POST

请求头部设置说明

  1. 相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：
  2. X-APICloud-AppId : {your app id}
  3. X-APICloud-AppKey : {you app key}

接口接收参数

  1. startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10
  2. endDate – 结束时间 格式：YYYY-MM-DD

接口返回数据

  1. 调用成功则返回相关应用各版本统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。
  2. 接口返回状态（st） ： 1－成功 0－失败
  3. 接口返回信息（msg）：－成功为相关应用各版本统计数据信息，失败则为错误信息。

返回数据示例

图片说明

返回字段说明

字段名称字段说明
id数据ID
appid应用ID
versionCode应用版本号
devicesCount该版本下设备总数
newRegsCount该版本下当天新注册用户数
newUpdateCount该版本下当天新升级用户数
activeCountInToday该版本下当天活跃用户数
totalUseTime该版本下应用累计使用时长
totalOperationCount该版本下应用累计使用次数
reportDate统计数据生成时间

接口名称：应用地理分布统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内的应用下各版本地理分布统计数据信息。

调用地址

https://r.apicloud.com/analytics/

调用方法

getGeoStatisticDataById

请求方式

POST

请求头部设置说明

  1. 相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：
  2. X-APICloud-AppId : {your app id}
  3. X-APICloud-AppKey : {you app key}

接口接收参数

  1. startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10
  2. endDate – 结束时间 格式：YYYY-MM-DD
  3. versionCode – 版本

接口返回数据

  1. 调用成功则返回相关应用各版本地理分布统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。
  2. 接口返回状态（st） ： 1－成功 0－失败
  3. 接口返回信息（msg）：－成功为相关应用地理分布统计数据信息，失败则为错误信息。

返回数据示例

图片说明

返回字段说明

字段名称字段说明
id数据ID
appid应用ID
versionCode版本号
geoNewRegsResult该版本下新增用户地理分布JSON数据集合
geoDevicesCountResult该版本下全部用户地理分布JSON数据集合
geoStartupCountResult该版本下全部启动次数地理分布JSON数据集合
geoActiveCountResult该版本下全部活跃用户地理分布JSON数据集合
reportDate统计数据生成时间

特别说明

geoNewRegsResult、geoDevicesCountResult、geoStartupCountResult、geoActiveCountResult相关数据均为JSON格式数据集合，单个数据对象由city及count属性构成，其中city为城市名城而count 则为对应省份（或城市）相关统计数据信息。

接口名称：应用设备分布统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内的应用下各版本设备信息分布统计数据信息。

调用地址

https://r.apicloud.com/analytics/

调用方法

getDeviceStatisticDataById

请求方式

POST

请求头部设置说明

  1. 相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：
  2. X-APICloud-AppId : {your app id}
  3. X-APICloud-AppKey : {you app key}

接口接收参数

  1. startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10
  2. endDate – 结束时间 格式：YYYY-MM-DD

接口返回数据

  1. 调用成功则返回相关应用各版本设备分布统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。
  2. 接口返回状态（st） ： 1－成功 0－失败
  3. 接口返回信息（msg）：－成功为相关应用各版本设备分布统计数据信息，失败则为错误信息。

返回数据示例

图片说明

返回字段说明

字段名称字段说明
id数据ID
appid应用ID
versionCode版本号
modelNewRegsResult当前版本下按型号区分新增用户数（JSON数据集合）
resolutionNewRegsResult当前版本下按分辨率区分新增用户数（JSON数据集合）
osNewRegsResult当前版本下按手机操作系统区分新增用户数（JSON数据集合）
connTypeResult当前版本下按手机联网方式区分连接次数数据（JSON数据集合）
modelNewActiveResult当前版本下按型号区分活跃用户数（JSON数据集合）
resolutionNewActiveResult当前版本下按分辨率区分活跃用户数（JSON数据集合）
osNewActiveResult当前版本下按手机操作系统区分活跃用户数（JSON数据集合）
modelTotalResult当前版本下按型号区分用户总数（JSON数据集合）
resolutionTotalResult当前版本下按分辨率区分用户总数（JSON数据集合）
osTotalResult当前版本下按手机操作系统区分用户总数（JSON数据集合）
connTypeTotalResult当前版本下按手机联网方式区分连接总次数数据（JSON数据集合）
reportDate统计数据生成时间

特别说明 modelNewRegsResult、resolutionNewRegsResult、osNewRegsResult、connTypeResult、modelNewActiveResult、resolutionNewActiveResult、osNewActiveResult、modelTotalResult、resolutionTotalResult、osTotalResult、connTypeTotalResult相关数据均为JSON格式数据集合，相关集合集合内各数据对象定义详见下表：

数据集合名称数据对象属性属性说明
modelNewRegsResult、modelNewActiveResult、modelTotalResultmodel、countmodel – 手机型号、count – 统计数据
resolutionNewRegsResult、resolutionNewActiveResult、resolutionTotalResultresolution、countresolution – 分辨率、count – 统计数据
osNewRegsResult、osNewActiveResult、osTotalResultos、countos – 手机操作系统、count – 统计数据
connTypeResult、connTypeTotalResultconnType、countconnType – 联网方式 、count – 统计数据

接口名称：应用异常错误统计信息获取接口

接口说明

该接口主要用于获取用户指定应用ID及时间范围内的应用下各版本异常错误统计数据信息。

调用地址

https://r.apicloud.com/analytics/

调用方法

getExceptionsStatisticDataById

请求方式

POST

请求头部设置说明

  1. 相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：
  2. X-APICloud-AppId : {your app id}
  3. X-APICloud-AppKey : {you app key}

接口接收参数

  1. startDate – 开始时间 格式：YYYY-MM-DD 例如：2014-10-10
  2. endDate – 结束时间 格式：YYYY-MM-DD

接口返回数据

  1. 调用成功则返回相关应用各版本异常统计数据信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。
  2. 接口返回状态（st） ： 1－成功 0－失败
  3. 接口返回信息（msg）：－成功为相关应用各版本异常统计数据信息，失败则为错误信息。

返回数据示例

图片说明

返回字段说明

字段名称字段说明
id数据ID
appid应用ID
versionCode版本号
model异常信息涉及机型
systemVersion异常信息系统版本
excepTitle异常摘要
excepCount异常发生数量
reportDate统计数据生成时间

接口名称：应用异常错误详细信息获取接口

接口说明

该接口主要用于根据应用异常错误摘要获取异常错误详细信息。

调用地址

https://r.apicloud.com/analytics/

调用方法

getExceptionsDetailByTitle

请求方式

POST

请求头部设置说明

  1. 相关接口调用需要在发送的请求头部设置相关应用ID及应用KEY。相关请求头部设置定义如下：
  2. X-APICloud-AppId : {your app id}
  3. X-APICloud-AppKey : {you app key}

接口接收参数

  1. title – 错误摘要信息

接口返回数据

  1. 调用成功则返回指定异常错误摘要的详细信息，失败则返回错误信息，相关数据信息均以JSON数据格式返回。
  2. 接口返回状态（st） ： 1－成功 0－失败
  3. 接口返回信息（msg）：－成功为指定异常错误摘要的详细信息，失败则为错误信息。

返回数据示例

图片说明

返回字段说明

字段名称字段说明
content异常错误具体信息