Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bir veya daha fazla müşteri için 100.000 adede kadar cihaz için hak talebinde bulunmaya yönelik asynkron istek.
Eşzamansız API yöntemleri, işlem tamamlanmadan önce sonuç döndürür. Ayrıca, uzun süren bir işlemin tamamlanmasını bekleyen kullanıcılarınız için uygulamanızın (veya aracınızın) duyarlı kalmasına yardımcı olurlar. Uygulamanız, işlemin durumunu düzenli olarak kontrol etmek için getOperation işlevini çağırmalıdır.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[[["\u003cp\u003eThis asynchronous API allows you to claim up to 100,000 devices for one or more customers.\u003c/p\u003e\n"],["\u003cp\u003eEach request using the \u003ccode\u003eResellerService\u003c/code\u003e class supports claiming devices for only one customer; attempting to claim for multiple customers will result in an \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe asynchronous method \u003ccode\u003eclaimDevicesAsync\u003c/code\u003e returns a result before processing is complete, and you must use \u003ccode\u003egetOperation\u003c/code\u003e to periodically check the status.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eClaimDevicesRequest\u003c/code\u003e requires a list of \u003ccode\u003eDeviceClaim\u003c/code\u003e objects, and each \u003ccode\u003eDeviceClaim\u003c/code\u003e must include a \u003ccode\u003eDeviceIdentifier\u003c/code\u003e and \u003ccode\u003eCompanyReference\u003c/code\u003e for the customer.\u003c/p\u003e\n"],["\u003cp\u003ePotential error codes include \u003ccode\u003eDEVICE_UPLOAD_COUNT_EXCEEDED\u003c/code\u003e, \u003ccode\u003eDUPLICATE_DEVICES\u003c/code\u003e, \u003ccode\u003eINTERNAL_SERVER_ERROR\u003c/code\u003e, and various \u003ccode\u003eINVALID\u003c/code\u003e errors related to customer, device identifiers, and device information.\u003c/p\u003e\n"]]],["The `claimDevicesAsync` method initiates an asynchronous request to claim up to 100,000 devices. Each request, using `ClaimDevicesRequest`, must specify a list of `DeviceClaim` objects, each detailing device identifiers and a customer. The `ResellerService` only supports one customer per request. The method returns `ClaimDevicesResponse` with `Operation` objects for tracking status. Errors, like `DEVICE_UPLOAD_COUNT_EXCEEDED` or `INTERNAL_SERVER_ERROR`, are reported within the `Operation` object.\n"],null,["Asynchronous request to claim up to 100,000 devices for one or more customers.\n| **Note:** The `ResellerService` class created by `SamsungResellerServiceFactory` only supports claiming devices for one customer per request. If devices for multiple customers are put into a single request, the operation will fail and return `INTERNAL_SERVER_ERROR`.\n\nAsynchronous API methods return a result before the processing is complete. They\nalso help your app (or tool) remain responsive for your users while they wait\nfor a long-running operation to complete. Your app should call\n[`getOperation`](/zero-touch/reseller-library/reference/methods/getoperation)\nto check the status of the operation periodically.\n\nMethod signature \n\n public ClaimDevicesResponse claimDevicesAsync(ClaimDevicesRequest request);\n\nClaimDeviceRequest\n\n| Property name | Value | Required | Description |\n|---------------|-------------------------------|----------|--------------------------------------------------|\n| `claims` | List of `object(DeviceClaim)` | Yes | List of device claims to claim for the customer. |\n\nDeviceClaim\n\n| Property name | Value | Required | Description |\n|--------------------|-----------------------------------------------------|----------|--------------------------------------------------------------------|\n| `deviceIdentifier` | `object(`[`DeviceIdentifier`](#deviceidentifier)`)` | Yes | Device identifier. |\n| `customer` | `CompanyReference` object | Yes | Company reference for the customer that the device is assigned to. |\n| `orderNumber` | `string` | No | Order number. |\n| `vendorParams` | `map` | No | Extra fields, vendor specified key-value pair. |\n\nClaimDeviceResponse\n\n| Property name | Value | Description |\n|---------------|-----------------------------|---------------------------------------------------|\n| `operations` | List of `Operation` objects | One or more `ClaimDevices` `Operation` instances. |\n\nError behavior\n\nIf an error occurs, the `Operation` object returns one of the following error\ncodes:\n\n| Error code |\n|--------------------------------|\n| `DEVICE_UPLOAD_COUNT_EXCEEDED` |\n| `DUPLICATE_DEVICES` |\n| `INTERNAL_SERVER_ERROR` |\n| `INVALID_CUSTOMER_ID` |\n| `INVALID_DEVICE_IMEI` |\n| `INVALID_DEVICE_MEID` |\n| `INVALID_DEVICE_SERIAL` |\n| `INVALID_IDENTIFIER_SET` |\n| `INVALID_MANUFACTURER` |\n| `INVALID_MODEL` |"]]
