Yêu cầu không đồng bộ để xác nhận quyền sở hữu tối đa 100.000 thiết bị cho một hoặc nhiều khách hàng.
Lưu ý: Lớp ResellerService
do SamsungResellerServiceFactory
tạo chỉ hỗ trợ việc xác nhận quyền sở hữu thiết bị cho một khách hàng trong mỗi yêu cầu. Nếu thiết bị của nhiều khách hàng được đưa vào một yêu cầu, thì thao tác này sẽ không thành công và trả về INTERNAL_SERVER_ERROR
.
Các phương thức API không đồng bộ trả về kết quả trước khi quá trình xử lý hoàn tất. Các API này cũng giúp ứng dụng (hoặc công cụ) của bạn duy trì khả năng phản hồi của người dùng trong khi họ chờ một thao tác chạy trong thời gian dài hoàn tất. Ứng dụng của bạn phải gọi getOperation
để kiểm tra trạng thái của thao tác theo định kỳ.
Chữ ký phương thức
public ClaimDevicesResponse claimDevicesAsync ( ClaimDevicesRequest request );
ClaimDeviceRequest
Tên tài sản
Giá trị
Bắt buộc
Mô tả
claims
Danh sách object(DeviceClaim)
Có
Danh sách các thông báo xác nhận quyền sở hữu thiết bị cần xác nhận quyền sở hữu cho khách hàng.
DeviceClaim
Tên tài sản
Giá trị
Bắt buộc
Mô tả
deviceIdentifier
object(
DeviceIdentifier
)
Có
Giá trị nhận dạng thiết bị.
customer
Đối tượng CompanyReference
Có
Thông tin tham khảo về công ty của khách hàng được chỉ định thiết bị.
orderNumber
string
Không
Số đơn đặt hàng.
vendorParams
map
Không
Các trường bổ sung, cặp khoá-giá trị do nhà cung cấp chỉ định.
ClaimDeviceResponse
Tên tài sản
Giá trị
Mô tả
operations
Danh sách đối tượng Operation
Một hoặc nhiều thực thể ClaimDevices
Operation
.
Hành vi lỗi
Nếu xảy ra lỗi, đối tượng Operation
sẽ trả về một trong các mã lỗi sau:
Mã lỗi
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