RemoteGymp · API v1

Conservez une copie synchronisée.

Copiez votre liste de périphériques sur un autre système, puis récupérez uniquement les éléments modifiés.

  1. Prendre un instantané complet

    Appeler POST /v1/sync/devices avec previousSnapshotId défini sur null. Lire GET /v1/sync/devices/{snapshotId}, en passant chaque valeur next comme after, jusqu'à ce que next soit null.

  2. Enregistrer le point de contrôle après chaque page.

    Appliquer chaque page, puis enregistrer l'ID de l'instantané. La prochaine fois, envoyer cet ID comme previousSnapshotId. Appliquer les enregistrements upsert en ajoutant ou en mettant à jour le périphérique ; supprimer les enregistrements marqués deleted, dont la valeur du périphérique est null. Sécuriser chaque page pour une application ultérieure. Conserver l'ancien point de contrôle jusqu'à la réussite complète de la mise à jour.

  3. Redémarrez si nécessaire.

    Si le point de contrôle expire avec le code 410, effectuez une nouvelle capture instantanée complète et comparez-la avec vos données enregistrées. Les captures instantanées appartiennent à l'identifiant qui les a créées ; un identifiant de remplacement nécessite donc sa propre base de référence.

  4. Conservez des points de contrôle distincts pour les autres types de données.

    Les captures instantanées des périphériques contiennent des résumés. L'inventaire détaillé, les logiciels, les alertes et les champs personnalisés utilisent chacun les identifiants POST et /v1/sync/{resource} et nécessitent leur propre point de contrôle.

  5. Limites des captures instantanées

    Les captures instantanées expirent après sept jours et peuvent contenir jusqu'à 10 000 périphériques. Chaque identifiant peut créer quatre captures instantanées par ressource et par organisation par heure ; chaque organisation peut en créer vingt au total par heure. Le stockage des instantanés compressés est limité à 256 MiB par organisation.

Référence API →

Révision du contenu 3f225a253 · OpenAPI SHA-256: b12c42306a89