claimDeviceAsync

בקשה אסינכררונית לשימוש ב-100,000 מכשירים ללקוח אחד או יותר.

שיטות API אסינכררוניות מחזירות תוצאה לפני שהעיבוד מסתיים. הם גם עוזרים לאפליקציה (או לכלי) להגיב למשתמשים בזמן שהם ממתינים להשלמת פעולה ממושכת. האפליקציה צריכה לבצע קריאה ל-getOperation כדי לבדוק את סטטוס הפעולה מדי פעם.

חתימה של method

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