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