AnspruchsgeräteAsynchron

Asynchrone Anfrage,um bis zu 100.000 Geräte für einen oder mehrere Kunden zu beanspruchen.

Asynchrone API-Methoden geben ein Ergebnis zurück, bevor die Verarbeitung abgeschlossen ist. Außerdem sorgen sie dafür, dass Ihre App (oder Ihr Tool) für Nutzer reaktionsschnell bleibt, während sie auf den Abschluss eines langwierigen Vorgangs warten. Ihre App sollte getOperation aufrufen, um den Status des Vorgangs regelmäßig zu prüfen.

Methodensignatur

public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

ClaimDeviceRequest

Property-Name Wert Erforderlich Beschreibung
claims Liste mit object(DeviceClaim) Ja Liste der Gerätereklamationen, die für den Kunden geltend gemacht werden sollen.

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
operations Liste der Operation-Objekte Eine oder mehrere ClaimDevices Operation-Instanzen.

Fehlerverhalten

Wenn ein Fehler auftritt, gibt das Objekt Operation einen der folgenden Fehlercodes zurück:

Fehlercode
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