claimDevice

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