RemoteGymp · API v1

Håll en kopia synkroniserad

Kopiera din enhetslista till ett annat system och hämta sedan bara det som ändrats.

  1. Ta en fullständig ögonblicksbild

    Anropa POST /v1/sync/devices med previousSnapshotId inställt på null. Läs GET /v1/sync/devices/{snapshotId} och skicka varje next-värde som after tills next är null.

  2. Spara din kontrollpunkt efter att varje sida har lyckats

    Tillämpa varje sida och spara sedan ögonblicksbilds-ID:t. Nästa gång, skicka det ID:t som previousSnapshotId. Tillämpa upsert-poster genom att lägga till eller uppdatera enheten; ta bort poster markerade deleted, vars enhetsvärde är null. Gör varje sida säker att tillämpa igen. Behåll din gamla kontrollpunkt tills hela uppdateringen lyckas.

  3. Börja om vid behov

    Om kontrollpunkten löper ut med 410, ta en ny fullständig ögonblicksbild och jämför den med dina sparade data. Ögonblicksbilder tillhör den autentiseringsuppgifter som skapade dem, så en ersättningsautentisering behöver sin egen baslinje.

  4. Håll separata kontrollpunkter för annan data

    Enhetsögonblicksbilder innehåller sammanfattningar. Detaljerad inventering, programvara, varningar och anpassade fält använder alla POST /v1/sync/{resource} och behöver sin egen kontrollpunkt.

  5. Gränser för ögonblicksbilder

    Ögonblicksbilder löper ut efter sju dagar och innehåller högst 10 000 enheter. Varje autentiseringsuppgifter kan skapa fyra ögonblicksbilder per resurs och organisation per timme; varje organisation kan skapa tjugo totalt per timme. Lagring av komprimerad ögonblicksbild är begränsad till 256 MiB per organisation.

API-referens →

Innehållsrevision 3f225a253 · OpenAPI SHA-256: b12c42306a89