AnspruchsgeräteAsynchron

Asynchrone Anfrage zur Anspruchserhebung auf bis zu 100.000 Geräte für einen oder mehrere Kunden.

Asynchrone API-Methoden geben ein Ergebnis zurück, bevor die Verarbeitung abgeschlossen ist. Sie können Sie auch dabei helfen, dass Ihre App (oder Ihr Tool) für die Nutzenden während der Wartezeiten responsiv bleibt. lange andauernden Vorgang abgeschlossen. Ihre App sollte folgende Aktionen ausführen: getOperation um den Status des Vorgangs regelmäßig zu überprüfen.

Methodensignatur

public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

ClaimDeviceRequest

Property-Name Wert Erforderlich Beschreibung
claims Liste mit object(DeviceClaim) Ja Liste der Geräteansprüche, die für den Kunden beansprucht 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 mit Operation Objekten Eine oder mehrere ClaimDevices Operation-Instanzen.

Fehlerverhalten

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

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