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