RemoteGymp · API v1

Gravar dados

Atualize os campos personalizados e as janelas de manutenção, execute a automatização e tente gravar novamente em segurança.

A API e o MCP suportam trabalhos em fila, energia programada, desinstalação de agentes, diagnósticos de endpoint, cancelamento de comandos e políticas de correções de terceiros. Reutilizar chaves de idempotência e inspecionar recibos. As credenciais temporárias de administrador são devolvidas uma vez. A monitorização de tráfego requer autorização existente; a faturação permanece na aplicação.

  1. Verifique as suas permissões.

    As predefinições selecionam as características individuais; não alteram o nível de acesso. As novas credenciais em Definições utilizam FullAccess por predefinição, mas apenas os recursos selecionados são permitidos. Credenciais mais antigas, como ReadWrite, permitem alterações aprovadas em campos personalizados e janelas de manutenção. A automação e o controlo de dispositivos exigem FullAccess, além das suas características específicas. Verifique GET e /v1/operations/capabilities antes de gravar. O âmbito da empresa e as permissões do proprietário atual ainda se aplicam.

  2. Evite sobrescrever outra alteração.

    Leia o campo personalizado e a sua versão. Envie o seu novo valor e a versão lida para PATCH /v1/custom-fields/{fieldId}.. Um erro 409 version_conflict significa que alguém já o alterou. Leia-o novamente e verifique se a sua atualização ainda é apropriada.

  3. Tente novamente em segurança.

    Para POST /v1/maintenance-windows, envie um cabeçalho Idempotency-Key. Após um resultado incerto, repita a mesma chave e corpo para recuperar a janela original em vez de criar um duplicado. Um corpo alterado com a mesma chave é rejeitado. DELETE /v1/maintenance-windows/{windowId} cancela uma janela.

  4. Acompanhe os recibos de ação.

    As gravações de automatização e gestão utilizam idempotencyKey no corpo JSON e devolvem um recibo de operação. Completed significa que o gestor de pedidos terminou; verifique o resultado ou a execução do domínio para saber se o dispositivo concluiu o trabalho. Para OutcomeUnknown, inspecione o recibo e o estado atual antes de decidir o que fazer. Nunca reenvie automaticamente com uma nova chave: a ação pode ser executada duas vezes.

Referência da API →

Revisão de conteúdos 3f225a253 · OpenAPI SHA-256: b12c42306a89