AnspruchsgeräteAsynchron

Asynchrone Anfrage zum Anfordern von bis zu 100.000 Geräten für einen oder mehrere Kunden.

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

Methodensignatur

public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

Geräteanfrage anfordern

Attributname Wert Erforderlich Beschreibung
claims Liste von object(DeviceClaim) Ja Liste der Geräteansprüche für den Kunden.

Geräte-Claim

Attributname 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.

Gerätereaktion anfordern

Attributname 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 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