تحديث الحقول المخصصة وفترات الصيانة، وتشغيل الأتمتة، وإعادة محاولة الكتابة بأمان.
تدعم واجهة API وMCP الوظائف المؤجلة، الطاقة المجدولة، إزالة تثبيت الوكيل، تشخيص نقاط النهاية، إلغاء الأوامر وسياسات تصحيح الأطراف الثالثة. أعد استخدام مفاتيح الوحدانية وافحص الإيصالات. يتم إرجاع بيانات اعتماد المسؤول المؤقتة مرة واحدة. مراقبة الحركة تتطلب امتيازًا موجودًا؛ الفوترة تبقى في التطبيق.
تحقق من صلاحياتك
تحدد الإعدادات المسبقة إمكانيات فردية، ولا تُغير مستوى الوصول. تستخدم بيانات الاعتماد الجديدة في الإعدادات FullAccess افتراضيًا، ولكن لا يُسمح إلا بالإمكانيات المحددة. تسمح بيانات الاعتماد القديمة ReadWrite بإجراء تغييرات معتمدة على الحقول المخصصة والصيانة. تتطلب الأتمتة والتحكم في الأجهزة FullAccess بالإضافة إلى إمكانياتها الخاصة. تحقق من GET و/v1/operations/capabilities قبل الكتابة. لا يزال نطاق الشركة وصلاحيات المالك الحالي سارية.
تجنب الكتابة فوق تغيير آخر
اقرأ الحقل المخصص وإصداره. أرسل القيمة الجديدة والإصدار الذي قرأته إلى PATCH /v1/custom-fields/{fieldId}.. يشير الرمز 409 version_conflict إلى أن شخصًا ما قام بتغييرها أولًا. اقرأها مرة أخرى وقرر ما إذا كان تحديثك لا يزال مناسبًا.
أعد المحاولة بأمان.
بالنسبة إلى POST /v1/maintenance-windows، أرسل ترويسة Idempotency-Key. في حال عدم التأكد من النتيجة، كرر نفس المفتاح والنص لاستعادة النافذة الأصلية بدلًا من إنشاء نسخة مكررة. سيتم رفض أي نص مُعدّل بنفس المفتاح. DELETE /v1/maintenance-windows/{windowId} يلغي النافذة.
متابعة إيصالات الإجراءات
تستخدم عمليات الكتابة الآلية والإدارية الرمز idempotencyKey في نص JSON، وتُعيد إيصال عملية. يشير الرمز Completed إلى انتهاء معالج الطلب؛ تحقق من النتيجة أو تشغيل النطاق لمعرفة ما إذا كان الجهاز قد أنهى العمل. بالنسبة للرمز OutcomeUnknown، افحص الإيصال والحالة الحالية قبل اتخاذ القرار. لا تُعِد الإرسال تلقائيًا باستخدام مفتاح جديد: فقد يُنفَّذ الإجراء مرتين.