声明设备异步

异步请求,可以为一个或多个客户声明最多 10 万台设备。

异步 API 方法会在处理完成之前返回结果。还可以帮助您的应用(或工具)在用户等待长时间运行的操作完成时始终保持响应。您的应用应定期调用 getOperation 以检查操作的状态。

方法签名

public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

版权主张设备请求

属性名称 价值 必需 说明
claims object(DeviceClaim)的列表 兼容 客户要认领的设备声明列表。

设备声明

属性名称 价值 必需 说明
deviceIdentifier object(DeviceIdentifier) 兼容 设备标识符。
customer CompanyReference 对象 兼容 分配了设备的客户的公司参考编号。
orderNumber string 订单号。
vendorParams map 额外字段,供应商指定的键值对。

声明设备响应

属性名称 价值 说明
operations Operation 对象列表 一个或多个 ClaimDevices Operation 实例。

错误行为

如果发生错误,Operation 对象会返回以下错误代码之一:

错误代码
DEVICE_UPLOAD_COUNT_EXCEEDED
DUPLICATE_DEVICES
INTERNAL_SERVER_ERROR
INVALID_CUSTOMER_ID
INVALID_DEVICE_IMEI
INVALID_DEVICE_MEID
INVALID_DEVICE_SERIAL
INVALID_IDENTIFIER_SET
INVALID_MANUFACTURER
INVALID_MODEL