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