עדכן שדות מותאמים אישית וחלונות תחזוקה, הפעל אוטומציה ונסה כתיבה חוזרת בצורה בטוחה.
ה-API ו-MCP תומכים בעבודות בתור, הפעלה מתוזמנת, הסרת סוכן, אבחון נקודת קצה, ביטול פקודות ומדיניות תיקוני צד שלישי. השתמש מחדש במפתחות איטומיות ובחן קבלות. אישורי מנהל זמניים מוחזרים פעם אחת. ניטור תנועה דורש זכאות קיימת; התשלום נשאר ביישום.
בדוק את ההרשאות שלך
הגדרות קבועות מראש בוחרות יכולות בודדות; הן אינן משנות את רמת הגישה. אישורים חדשים בהגדרות משתמשים ב-FullAccess כברירת מחדל, אך רק היכולות שנבחרו מותרות. אישורים ישנים יותר של ReadWrite מאפשרים שינויים מאושרים בשדות מותאמים אישית ובתחזוקה. אוטומציה ובקרת מכשירים זקוקים ל-FullAccess בתוספת היכולות הספציפיות שלהן. בדוק את GET /v1/operations/capabilities לפני הכתיבה. היקף החברה והרשאות הבעלים הנוכחיות עדיין חלות.
הימנע מהחלפת שינוי נוסף
קרא את השדה המותאם אישית ואת הגרסה שלו. שלח את הערך החדש שלך ואת הגרסה שקראת ל-PATCH /v1/custom-fields/{fieldId}. A 409 version_conflict פירושו שמישהו שינה אותו קודם. קרא אותו שוב והחליט אם העדכון שלך עדיין מתאים.
נסה שוב בבטחה
עבור POST /v1/maintenance-windows, שלח כותרת Idempotency-Key. לאחר תוצאה לא ודאית, חזור על אותו מפתח וגוף כדי לאחזר את החלון המקורי במקום ליצור עותק. גוף שהשתנה עם אותו מפתח נדחה. DELETE /v1/maintenance-windows/{windowId} מבטל חלון.
קבלות פעולות מעקב
כתיבות אוטומציה וניהול משתמשות ב-idempotencyKey בגוף JSON ומחזירות קבלה לפעולה. Completed פירושו שמטפל הבקשה הסתיים; בדוק את התוצאה או את הפעלת הדומיין כדי ללמוד האם המכשיר סיים את העבודה. עבור OutcomeUnknown, בדוק את הקבלה ואת המצב הנוכחי לפני שתחליט מה לעשות. לעולם אל תשלח מחדש באופן אוטומטי תחת מפתח חדש: הפעולה עלולה להתבצע פעמיים.