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

说明 目前只支持返回天的数据，天维度最多支持查31天内数据，天以北京时间为准。

调试

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

请求参数

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

系统规定参数。取值：QueryDeviceStat。

AppKey Long 是 23267207

AppKey信息。
StartTime String 是 2016-07-28T00:00:00Z

查询的开始时间。时间格式按照ISO8601标准表示，并需要使用UTC时间，格式为YYYY-MM-DDThh:mm:ssZ。

注：统计开始日期为开始时间当天北京时间0点。
EndTime String 是 2016-07-29T00:00:00Z

查询的结束时间。时间格式按照ISO8601标准表示，并需要使用UTC时间，格式为YYYY-MM-DDThh:mm:ssZ。

注：统计结束日期为结束时间当天。
DeviceType String 是 iOS

设备类型，取值范围为：

  • iOS：iOS设备
  • ANDROID：Andriod设备
  • ALL：全部类型设备
QueryType String 是 TOTAL

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

  • NEW：新增设备
  • TOTAL：累计设备数

返回数据

名称 类型 示例值 描述
RequestId String 9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC

请求ID。
AppDeviceStats Array of AppDeviceStat

设备统计数据AppDeviceStat组成的数组。
AppDeviceStat
Time String 2016-07-28T16:00:00Z

截止时间。时间格式按照ISO8601标准表示，并使用UTC时间，格式为YYYY-MM-DDThh:mm:ssZ。
DeviceType String iOS

设备类型。
Count Long 100

设备数。

示例

请求示例

http(s)://[Endpoint]/?Action=QueryDeviceStat
&AppKey=23267207
&StartTime=2016-07-28T00:00:00Z
&EndTime=2016-07-29T00:00:00Z
&DeviceType=iOS
&QueryType=TOTAL
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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