声明设备异步

用于为一个或多个客户声明最多 10 万部设备的异步请求。

异步 API 方法会在处理完成之前返回一个结果。它们还有助于您的应用(或工具)在用户等待长时间运行的操作完成时及时响应。您的应用应调用 getOperation 以定期检查操作状态。

方法签名

public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

ClaimDeviceRequest

属性名称 值 必填 说明
claims object(DeviceClaim) 的列表 是 要为客户提出的设备退款声明列表。

DeviceClaim

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

ClaimDeviceResponse

属性名称 值 说明
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