Gerät beanspruchen

Synchrone Anfrage, um ein einzelnes Gerät für einen bestimmten Kunden zu beanspruchen.

Methodensignatur

public ClaimDeviceResponse claimDevice(ClaimDeviceRequest request) throws CommonException;

ClaimDeviceRequest

Property-Name	Wert	Erforderlich	Beschreibung
claim	DeviceClaim Objekt	Ja	Der zu verarbeitende Geräteanspruch.

DeviceClaim

Property-Name	Wert	Erforderlich	Beschreibung
deviceIdentifier	object(DeviceIdentifier)	Ja	Geräte-ID.
customer	CompanyReference-Objekt	Ja	Unternehmensreferenz für den Kunden, dem das Gerät zugewiesen ist.
orderNumber	string	Nein	Bestellnummer
vendorParams	map	Nein	Zusätzliche Felder, vom Anbieter angegebenes Schlüssel/Wert-Paar.

ClaimDeviceResponse

Property-Name	Wert	Beschreibung
deviceId	string	Geräte-ID mit dem Präfix „samsung/“ oder „google/“.

Fehlerverhalten

Wenn ein Fehler auftritt, gibt die Bibliothek einen CommonException mit einem der folgenden Fehlercodes zurück:

Fehlercode
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