تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب غير متزامن للمطالبة بما يصل إلى 100,000 جهاز لعميل واحد أو أكثر
تعرِض طُرق واجهة برمجة التطبيقات غير المتزامنة نتيجة قبل اكتمال المعالجة. بالإضافة إلى ذلك، تساعد التطبيقات (أو الأداة) في الحفاظ على استجابة المستخدمين أثناء انتظار اكتمال عملية طويلة الأمد. يجب أن يستدعي تطبيقك getOperation
للتحقّق من حالة العملية بشكل دوري.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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` |"]]
