调用QueryDeviceStat查询App维度的设备统计。

说明 目前只支持返回天的数据,天维度最多支持查31天内数据。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String QueryDeviceStat

系统规定参数。取值:QueryDeviceStat

AppKey Long 23267207

AppKey信息。

DeviceType String iOS

设备类型,取值范围为:

  • iOS:iOS设备
  • ANDROID:Andriod设备
  • ALL:全部类型设备
EndTime String 2016-07-29T00:00:00Z

查询的结束时间。ISO-8601格式,格式为YYYY-MM-DDThh:mm:ssZ。

QueryType String TOTAL

查询的是新增设备数还是历史累计设备数。可取值:

  • NEW:新增设备
  • TOTAL:累计设备数
StartTime String 2016-07-28T00:00:00Z

查询的开始时间。ISO-8601格式,格式为YYYY-MM-DDThh:mm:ssZ。

返回数据

名称 类型 示例值 描述
AppDeviceStats Array

设备统计数据AppDeviceStat组成的数组。

AppDeviceStat
Count Long 100

设备数。

DeviceType String iOS

设备类型。

Time String 2016-07-28T00:00:00Z

截止时间。

RequestId String 9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC

请求ID。

示例

请求示例

http(s)://cloudpush.aliyuncs.com/?Action=QueryDeviceStat
&AppKey=23267207
&DeviceType=iOS
&EndTime=2016-07-29T00:00:00Z
&QueryType=TOTAL
&StartTime=2016-07-28T00:00:00Z
&<公共请求参数>

正常返回示例

XML 格式

<QueryDeviceStatResponse>
      <RequestId>9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC</RequestId>
      <AppDeviceStats>
          <AppDeviceStat>
              <Time>2016-07-28T00:00:00Z</Time>
              <Count>100</Count>
              <DeviceType>iOS</DeviceType>
          </AppDeviceStat>
          <AppDeviceStat>
              <Time>2016-07-29T00:00:00Z</Time>
              <Count>100</Count>
              <DeviceType>iOS</DeviceType>
          </AppDeviceStat>
      </AppDeviceStats>
</QueryDeviceStatResponse>

JSON 格式

{
  "RequestId": "9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC",
  "AppDeviceStats": [
    {
      "Time": "2016-07-28T00:00:00Z",
      "Count": 100,
      "DeviceType": "iOS"
    },
    {
      "Time": "2016-07-29T00:00:00Z",
      "Count": 100,
      "DeviceType": "iOS"
    }
  ]
}

错误码

访问错误中心查看更多错误码。