Оновіть користувацькі поля та вікна обслуговування, запустіть автоматизацію та повторіть спробу запису безпечно.
API та MCP підтримують чергові завдання, заплановане живлення, видалення агента, діагностику кінцевих точок, скасування команд та політики оновлень третіх сторін. Використовуйте повторно ключі ідемпотентності та перевіряйте квитанції. Тимчасові облікові дані адміністратора повертаються один раз. Моніторинг трафіку потребує наявного права; оплата залишаєтьcя в додатку.
Перевірте свої дозволи
Попередні налаштування вибирають окремі можливості; вони не змінюють рівень доступу. Нові облікові дані в налаштуваннях за замовчуванням використовують 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 перевірте отримання та поточний стан, перш ніж вирішувати, що робити. Ніколи не надсилайте автоматично повторно під новим ключем: дія може виконатися двічі.