调用QueryDeviceInfo查询设备详情。

调试

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

请求参数

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

系统规定参数。取值:QueryDeviceInfo

AppKey Long 23419851

AppKey信息。

DeviceId String a64ae296f3b04a58a05b30c9****

设备在推送系统中的唯一标识,一次只能查询一个。

返回数据

名称 类型 示例值 描述
DeviceInfo Struct

设备详情。

Account String test@aliyun.com

设备绑定的账户。

Alias String test_alias,test_alias2

设备绑定的别名。

DeviceId String a64ae296f3b04a58a05b30c95****

设备ID。

DeviceToken String 5ecc7b4012aaa801b63******5543ccbda6b4930d09629e936e1ac4b762a7df

设备令牌。

DeviceType String iOS

设备类型。

LastOnlineTime String 2018-03-27T02:19:40Z

最近一次上线时间。

Online Boolean false

是否在线。

PhoneNumber String 133********

手机号。

PushEnabled Boolean true

是否开启推送功能。

Tags String test_tag,test_tag2

设备绑定的标签。

RequestId String 6EEF262B-EA7D-41DC-89B9-20F3D1E28194

请求ID。

示例

请求示例

http(s)://cloudpush.aliyuncs.com/?Action=QueryDeviceInfo
&AppKey=23419851
&DeviceId=a64ae296f3b04a58a05b30c9****
&<公共请求参数>

正常返回示例

XML 格式

<QueryDeviceInfoResponse>
      <RequestId>9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC</RequestId>
      <DeviceInfo>
          <Account>test@aliyun.com</Account>
          <Tags>test_tag,test_tag2</Tags>
          <Alias>test_alias,test_alias2</Alias>
          <DeviceId>a64ae296f3b04a58a05b30c95****</DeviceId>
          <DeviceToken>5ecc7b4012aaa801b63*****3ccbda6b4930d09629e936e1ac4b762a7df</DeviceToken>
          <DeviceType>iOS</DeviceType>
          <Online>false</Online>
          <LastOnlineTime>2018-03-27T02:19:40Z</LastOnlineTime>
          <PushEnabled>true</PushEnabled>
      </DeviceInfo>
</QueryDeviceInfoResponse>

JSON 格式

{
  "RequestId": "6EEF262B-EA7D-41DC-89B9-20F3D1E28194",
  "DeviceInfo": {
    "Account": "test@aliyun.com",
    "Tags": "test_tag,test_tag2",
    "Alias": "test_alias,test_alias2",
    "DeviceId": "a64ae296f3b04a58a05b30c9****",
    "DeviceToken": "5ecc7b4012aaa801b63*****43ccbda6b4930d09629e936e1ac4b762a7df",
    "DeviceType": "iOS",
    "Online": false,
    "LastOnlineTime": "2018-03-27T02:19:40Z",
    "PushEnabled":true
  }
}

错误码

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