RemoteGymp · API v1

Simpan salinan yang sinkron

Salin daftar perangkat Anda ke sistem lain, lalu ambil hanya yang berubah.

  1. Ambil snapshot lengkap

    Panggil POST /v1/sync/devices dengan previousSnapshotId diatur ke null. Baca GET /v1/sync/devices/{snapshotId}, teruskan setiap nilai next sebagai after, hingga next menjadi null.

  2. Simpan checkpoint Anda setelah setiap halaman berhasil

    Terapkan setiap halaman, lalu simpan ID snapshot. Lain kali, kirim ID tersebut sebagai previousSnapshotId. Terapkan catatan upsert dengan menambahkan atau memperbarui perangkat; hapus catatan yang ditandai deleted, yang nilai perangkatnya adalah null. Jadikan setiap halaman aman untuk diterapkan lagi. Simpan checkpoint lama Anda hingga seluruh pembaruan berhasil.

  3. Mulai lagi jika diperlukan

    Jika checkpoint kedaluwarsa dengan kode 410, ambil snapshot lengkap baru dan bandingkan dengan data yang Anda simpan. Snapshot milik kredensial yang membuatnya, jadi kredensial pengganti memerlukan baseline sendiri.

  4. Simpan checkpoint terpisah untuk data lain

    Snapshot perangkat berisi ringkasan. Inventaris terperinci, perangkat lunak, peringatan, dan bidang kustom masing-masing menggunakan POST /v1/sync/{resource} dan memerlukan checkpoint sendiri.

  5. Batasan snapshot

    Snapshot kedaluwarsa setelah tujuh hari dan menyimpan maksimal 10.000 perangkat. Setiap kredensial dapat membuat empat snapshot per sumber daya dan organisasi per jam; Setiap organisasi dapat membuat total dua puluh snapshot per jam. Penyimpanan snapshot terkompresi dibatasi hingga 256 MiB per organisasi.

Referensi API →

Revisi konten 3f225a253 · OpenAPI SHA-256: b12c42306a89