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