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