声明设备异步

用于为一个或多个客户声明最多 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