Synchronous request to claim a single device for a specified customer.
Method signature
public ClaimDeviceResponse claimDevice(ClaimDeviceRequest request) throws CommonException;
ClaimDeviceRequest
| Property name |
Value |
Required |
Description |
claim |
DeviceClaim object |
Yes |
The device claim to be processed. |
DeviceClaim
| Property name |
Value |
Required |
Description |
deviceIdentifier |
object(DeviceIdentifier) |
Yes |
Device identifier. |
customer |
CompanyReference object |
Yes |
Company reference for the customer that the device is assigned to. |
orderNumber |
string |
No |
Order number. |
vendorParams |
map |
No |
Extra fields, vendor specified key-value pair. |
ClaimDeviceResponse
| Property name |
Value |
Description |
deviceId |
string |
The device ID, prefixed with 'samsung/' or 'google/'. |
Error behavior
If an error occurs, the library throws a CommonException containing one of the
following error codes:
| Error code |
AUTHORIZATION_FAIL |
DUPLICATE_DEVICES |
INVALID_CUSTOMER_ID |
INVALID_DEVICE_IMEI |
INVALID_DEVICE_MEID |
INVALID_DEVICE_SERIAL |
INVALID_IDENTIFIER_SET |
INVALID_MANUFACTURER |
INVALID_MODEL |
NOT_IMPLEMENTED |