以非同步要求為一或多位客戶聲明最多 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 |