請求デバイス非同期

1 人以上のお客様に対して最大 100,000 台のデバイスを申請するための非同期リクエスト。

非同期 API メソッドは、処理が完了する前に結果を返します。また、長時間実行オペレーションの完了を待機している間、アプリ(またはツール)がユーザーに対して応答し続けるのにも役立ちます。アプリは getOperation を呼び出して、オペレーションのステータスを定期的に確認する必要があります。

メソッド シグネチャ

public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);

ClaimDeviceRequest

プロパティ名 値 必須 説明
claims object(DeviceClaim) のリスト はい お客様に代わって申し立てを行うデバイスの申し立てのリスト。

DeviceClaim

プロパティ名 値 必須 説明
deviceIdentifier object(DeviceIdentifier) はい デバイス ID。
customer CompanyReference オブジェクト はい デバイスが割り当てられているお客様の会社照会番号。
orderNumber string いいえ 注文番号。
vendorParams map いいえ 追加フィールド、ベンダー指定の Key-Value ペア。

ClaimDeviceResponse

プロパティ名 値 説明
operations Operation オブジェクトのリスト 1 つ以上の 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