طلب غير متزامن للمطالبة بما يصل إلى 100,000 جهاز لعميل واحد أو أكثر
ملاحظة: الفئة ResellerService
التي أنشأها SamsungResellerServiceFactory
تتيح المطالبة بالأجهزة لعميل واحد فقط لكل طلب. وإذا تم إدخال أجهزة لعدة عملاء في طلب واحد، لن تنجح العملية وتعيد INTERNAL_SERVER_ERROR
.
تعرِض طُرق واجهة برمجة التطبيقات غير المتزامنة نتيجة قبل اكتمال المعالجة. بالإضافة إلى ذلك، تساعد التطبيقات (أو الأداة) في الحفاظ على استجابة المستخدمين أثناء انتظار اكتمال عملية طويلة الأمد. يجب أن يستدعي تطبيقك getOperation
للتحقّق من حالة العملية بشكل دوري.
توقيع الطريقة
public ClaimDevicesResponse claimDevicesAsync ( ClaimDevicesRequest request );
ClaimDeviceRequest
اسم الموقع
القيمة
مطلوب
الوصف
claims
تمثّل هذه السمة قائمة object(DeviceClaim)
.
نعم
قائمة بمطالبات الأجهزة التي سيتم تقديمها نيابةً عن العميل
DeviceClaim
اسم الموقع
القيمة
مطلوب
الوصف
deviceIdentifier
object(
DeviceIdentifier
)
نعم
معرّف الجهاز
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