异步请求,可以为一个或多个客户声明最多 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 |