Asynchroniczne żądanie rezerwacji do 100 000 urządzeń dla jednego lub większej liczby klientów.
Uwaga: klasa ResellerService
utworzona przez użytkownika SamsungResellerServiceFactory
obsługuje tylko deklarowanie urządzeń przez 1 klienta na każde żądanie. Jeśli urządzenia należące do różnych klientów zostaną umieszczone w jednym żądaniu, operacja zakończy się niepowodzeniem i zwróci INTERNAL_SERVER_ERROR
.
Metody asynchroniczne interfejsu API zwracają wynik przed zakończeniem przetwarzania. Pomagają też Twojej aplikacji (lub narzędziu) w reagowaniu na działania użytkowników, gdy oczekują na zakończenie długo trwającej operacji. Aplikacja powinna wywoływać funkcję getOperation
, aby okresowo sprawdzać stan operacji.
podpis metody,
public ClaimDevicesResponse claimDevicesAsync ( ClaimDevicesRequest request );
ClaimDeviceRequest
Nazwa usługi
Wartość
Wymagane
Opis
claims
Lista wartości object(DeviceClaim)
Tak
Lista roszczeń dotyczących urządzeń, które mają być zgłoszone w imieniu klienta.
DeviceClaim
Nazwa usługi
Wartość
Wymagane
Opis
deviceIdentifier
object(
DeviceIdentifier
)
Tak
Identyfikator urządzenia.
customer
CompanyReference
obiekt
Tak
Informacje o firmie klienta, któremu przypisane jest urządzenie.
orderNumber
string
Nie
Numer zamówienia.
vendorParams
map
Nie
Dodatkowe pola, pary klucz-wartość określone przez dostawcę.
ClaimDeviceResponse
Nazwa usługi
Wartość
Opis
operations
Lista Operation
obiektów
Co najmniej 1 instancja ClaimDevices
Operation
.
Zachowanie w przypadku błędu
Jeśli wystąpi błąd, obiekt Operation
zwraca jeden z tych kodów błędu:
Kod błędu
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