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

调试

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

请求参数

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

系统规定参数。取值：CheckDevices。
AppKey Long 是 23419851

AppKey信息。
DeviceIds String 是 ae296f3b04a58a05b30c95f****,ae296f3b04a58a05b30c95f****,ae296f3b04a58a05b30c95f****

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

返回数据

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

请求ID。
DeviceCheckInfos Array of DeviceCheckInfo

批量设备有效性检查结果。
DeviceCheckInfo
DeviceId String ae296f3b04a58a05b30c95f****

设备ID。
Available Boolean true

是否可用。

示例

请求示例

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

正常返回示例

XML格式

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

<?xml version='1.0' encoding='UTF-8'?>
<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格式

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

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

错误码

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