claimDevicesAsync

非同步要求,為一或多位客戶聲明最多 100,000 部裝置。

非同步 API 方法會在處理程序完成前傳回結果。這類工具還可讓應用程式 (或工具) 在使用者等待長時間作業完成時,維持回應效率。應用程式應呼叫 getOperation,定期檢查作業狀態。

方法簽章

public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

ClaimDeviceRequest

屬性名稱 必填 說明
claims object(DeviceClaim) 的清單 客戶聲明的裝置聲明清單。

DeviceClaim

屬性名稱 必填 說明
deviceIdentifier object(DeviceIdentifier) 裝置 ID。
customer CompanyReference 個物件 裝置獲派的客戶的公司參考資料。
orderNumber string 訂單號碼。
vendorParams map 額外欄位,供應商指定的鍵/值組合。

ClaimDeviceResponse

屬性名稱 說明
operations Operation 物件清單 一或多個 ClaimDevices Operation 例項。

錯誤行為

如果發生錯誤,Operation 物件會傳回下列其中一個錯誤代碼:

錯誤代碼
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