调用CheckDevices批量验证设备有效性。

调试

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

请求参数

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

系统规定参数。取值:CheckDevices。

AppKey Long 23419851

AppKey信息。

DeviceIds String ae296f3b04a58a05b30c95f****,ae296f3b04a58a05b30c95f****,ae296f3b04a58a05b30c95f****

设备在推送的唯一标识,32位,数字和小写字母组合,多个设备查询用“,”分割,一次最多查100个。

返回数据

名称 类型 示例值 描述
DeviceCheckInfos Array

批量设备有效性检查结果。

DeviceCheckInfo
Available Boolean true

是否可用。

DeviceId String ae296f3b04a58a05b30c95f****

设备ID。

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

请求ID。

示例

请求示例

http(s)://cloudpush.aliyuncs.com/?Action=CheckDevices
&AppKey=23419851
&DeviceIds=ae296f3b04a58a05b30c95f****,ae296f3b04a58a05b30c95f****,ae296f3b04a58a05b30c95f****
&<公共请求参数>

正常返回示例

XML 格式

<CheckDevicesResponse>
      <RequestId>9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC</RequestId>
      <DeviceCheckInfos>
            <DeviceCheckInfo>
                  <DeviceId>ae296f3b04a58a05b30c95f1****</DeviceId>
                  <Available>true</Available>
            </DeviceCheckInfo>
            <DeviceCheckInfo>
                  <DeviceId>ae296f3b04a58a05b30c95f1****</DeviceId>
                  <Available>true</Available>
            </DeviceCheckInfo>
            <DeviceCheckInfo>
                  <DeviceId>ae296f3b04a58a05b30c95f1****</DeviceId>
                  <Available>false</Available>
            </DeviceCheckInfo>
      </DeviceCheckInfos>
</CheckDevicesResponse>

JSON 格式

{
  "RequestId": "9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC",
  "DeviceCheckInfos": [
    {
      "DeviceId": "ae296f3b04a58a05b30c95f1****",
      "Available": "true"
    },
    {
      "DeviceId": "ae296f3b04a58a05b30c95f1****",
      "Available": "true"
    },                     
    {
      "DeviceId": "ae296f3b04a58a05b30c95f1****",
      "Available": "true"
    }
  ]
}

错误码

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