RemoteGymp · API v1

Hold en kopi synkroniseret

Kopier din enhedsliste til et andet system, og hent derefter kun det, der er ændret.

  1. Tag et fuldt snapshot

    Kald POST /v1/sync/devices med previousSnapshotId indstillet til null. Læs GET /v1/sync/devices/{snapshotId}, og send hver next-værdi som after, indtil next er null.

  2. Gem dit checkpoint, når hver side er gennemført.

    Anvend hver side, og gem derefter snapshot-ID'et. Næste gang skal du sende dette ID som previousSnapshotId. Anvend upsert-poster ved at tilføje eller opdatere enheden; fjern poster markeret med deleted, hvis enhedsværdi er null. Gør hver side sikker at anvende igen. Behold dit gamle checkpoint, indtil hele opdateringen er gennemført.

  3. Start forfra efter behov

    Hvis kontrolpunktet udløber med 410, skal du tage et nyt fuldt snapshot og sammenligne det med dine gemte data. Snapshots tilhører den legitimationsoplysninger, der oprettede dem, så en erstatningslegitimation skal have sin egen baseline.

  4. Hold separate kontrolpunkter for andre data

    Enhedssnapshots indeholder opsummeringer. Detaljeret lagerbeholdning, software, advarsler og brugerdefinerede felter bruger hver især POST /v1/sync/{resource} og skal have deres eget kontrolpunkt.

  5. Snapshot-grænser

    Snapshots udløber efter syv dage og indeholder højst 10.000 enheder. Hver legitimationsoplysninger kan oprette fire snapshots pr. ressource og organisation pr. time; hver organisation kan oprette tyve i alt pr. time. Komprimeret snapshot-lagring er begrænset til 256 MiB pr. organisation.

API-reference →

Indholdsrevision 3f225a253 · OpenAPI SHA-256: b12c42306a89