调用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
  } ]
}

错误码

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