RemoteGymp · API v1

Zapis dat

Aktualizujte vlastní pole a okna údržby, spusťte automatizaci a bezpečně opakujte zápisy.

API a MCP podporují fronty úloh, plánovanou energii, odinstalaci agenta, diagnostiku koncového bodu, zrušení příkazů a politiky záplat třetích stran. Znovu použijte klíče idempotence a zkontrolujte potvrzení. Dočasné administrační údaje jsou vráceny jednou. Monitorování provozu vyžaduje existující nárok; fakturace zůstává v aplikaci.

  1. Zkontrolujte svá oprávnění

    Předvolby vybírají jednotlivé funkce; nemění úroveň přístupu. Nové přihlašovací údaje v Nastavení standardně používají FullAccess, ale povoleny jsou pouze vybrané funkce. Starší přihlašovací údaje ReadWrite umožňují schválené změny vlastních polí a údržby. Automatizace a ovládání zařízení vyžadují FullAccess a jejich specifické funkce. Před zápisem zkontrolujte GET /v1/operations/capabilities. Stále platí rozsah společnosti a aktuální oprávnění vlastníka.

  2. Zabraňte přepsání další změny

    Přečtěte si vlastní pole a jeho verzi. Odešlete novou hodnotu a verzi, kterou jste si přečetli, na PATCH /v1/custom-fields/{fieldId}. A 409 version_conflict znamená, že ji někdo změnil jako první. Přečtěte si ji znovu a rozhodněte se, zda je vaše aktualizace stále vhodná.

  3. Zkuste to bezpečně znovu

    Pro POST /v1/maintenance-windows odešlete hlavičku Idempotency-Key. Po nejistém výsledku opakujte stejný klíč a tělo pro načtení původního okna, nikoli pro vytvoření duplikátu. Změněné tělo se stejným klíčem je odmítnuto. DELETE /v1/maintenance-windows/{windowId} ruší okno.

  4. Potvrzení o provedení akce

    Automatizační a řídicí zápisy používají idempotencyKey v těle JSON a vracejí potvrzení o operaci. Completed znamená, že obslužná rutina požadavku byla dokončena; zkontrolujte výsledek nebo spuštění domény, abyste zjistili, zda zařízení dokončilo práci. V případě OutcomeUnknown zkontrolujte příjem a aktuální stav před rozhodnutím, co dělat. Nikdy automaticky znovu neodesílejte pod novým klíčem: akce by se mohla spustit dvakrát.

Referenční příručka API →

Revize obsahu 3f225a253 · OpenAPI SHA-256: b12c42306a89