RemoteGymp · API v1

Skriv data

Opdater brugerdefinerede felter og vedligeholdelsesvinduer, kør automatisering, og prøv at skrive sikkert igen.

API'en og MCP understøtter kødannede job, planlagt strøm, agent-afinstallation, endpoint-diagnostik, kommandoannullering og tredjeparts patch-politikker. Genbrug idempotens nøgler og kontroller kvitteringer. Midlertidige administratorlegitimationsoplysninger returneres én gang. Trafikovervågning kræver eksisterende rettighed; fakturering forbliver i applikationen.

  1. Tjek dine tilladelser

    Forudindstillinger vælger individuelle funktioner; de ændrer ikke adgangsniveauet. Nye legitimationsoplysninger i Indstillinger bruger FullAccess som standard, men kun de valgte funktioner er tilladt. Ældre ReadWrite-legitimationsoplysninger tillader godkendte ændringer af brugerdefinerede felter og vedligeholdelse. Automatisering og enhedsstyring kræver FullAccess plus deres specifikke funktioner. Tjek GET /v1/operations/capabilities før skrivning. Virksomhedens omfang og de nuværende ejertilladelser gælder stadig.

  2. Undgå at overskrive en anden ændring

    Læs det brugerdefinerede felt og dets version. Send din nye værdi og den version, du læste, til PATCH /v1/custom-fields/{fieldId}. A 409 version_conflict betyder, at nogen har ændret den først. Læs den igen, og afgør, om din opdatering stadig er relevant.

  3. Prøv sikkert igen

    For POST /v1/maintenance-windows, send en Idempotency-Key header. Efter et usikkert resultat, gentag den samme nøgle og brødtekst for at hente det originale vindue i stedet for at oprette en duplikat. En ændret brødtekst med den samme nøgle afvises. DELETE /v1/maintenance-windows/{windowId} annullerer et vindue.

  4. Kvitteringer for følgehandlinger

    Automatiserings- og administrationsskrivninger bruger idempotencyKey i JSON-brødteksten og returnerer en operationskvittering. Completed betyder, at anmodningshåndtereren er færdig; Kontrollér resultatet eller domænekørslen for at finde ud af, om enheden har afsluttet arbejdet. For OutcomeUnknown skal du kontrollere kvitteringen og den aktuelle tilstand, før du beslutter dig for, hvad du skal gøre. Send aldrig automatisk igen under en ny nøgle: handlingen kan køre to gange.

API-reference →

Indholdsrevision 3f225a253 · OpenAPI SHA-256: b12c42306a89