RemoteGymp · API v1

Εγγραφή δεδομένων

Ενημερώστε τα προσαρμοσμένα πεδία και τα παράθυρα συντήρησης, εκτελέστε αυτοματοποίηση και προσπαθήστε ξανά τις εγγραφές με ασφάλεια.

Το API και το MCP υποστηρίζουν προγραμματισμένες εργασίες σε ουρά, προγραμματισμένη τροφοδοσία, απεγκατάσταση πράκτορα, διαγνωστικά τερματικού, ακύρωση εντολών και πολιτικές ενημερώσεων τρίτων. Επαναχρησιμοποιήστε κλειδιά αμεταβλητότητας και ελέγξτε τις αποδείξεις. Οι προσωρινές διαπιστευτήρια διαχειριστή επιστρέφονται μία φορά. Η παρακολούθηση κυκλοφορίας απαιτεί υπάρχουσα άδεια· η τιμολόγηση παραμένει στην εφαρμογή.

  1. Ελέγξτε τα δικαιώματά σας

    Οι προεπιλογές επιλέγουν μεμονωμένες δυνατότητες. Δεν αλλάζουν το επίπεδο πρόσβασης. Τα νέα διαπιστευτήρια στις Ρυθμίσεις χρησιμοποιούν το FullAccess από προεπιλογή, αλλά επιτρέπονται μόνο οι επιλεγμένες δυνατότητες. Τα παλαιότερα διαπιστευτήρια ReadWrite επιτρέπουν εγκεκριμένες αλλαγές σε προσαρμοσμένα πεδία και συντήρηση. Ο αυτοματισμός και ο έλεγχος συσκευών χρειάζονται το FullAccess συν τις συγκεκριμένες δυνατότητές τους. Ελέγξτε το GET /v1/operations/capabilities πριν από την εγγραφή. Το εύρος της εταιρείας και τα δικαιώματα του τρέχοντος κατόχου εξακολουθούν να ισχύουν.

  2. Αποφύγετε την αντικατάσταση μιας άλλης αλλαγής

    Διαβάστε το προσαρμοσμένο πεδίο και την έκδοσή του. Στείλτε τη νέα σας τιμή και την έκδοση που διαβάσατε στο PATCH /v1/custom-fields/{fieldId}.. Το A 409 version_conflict σημαίνει ότι κάποιος την άλλαξε πρώτα. Διαβάστε το ξανά και αποφασίστε εάν η ενημέρωσή σας εξακολουθεί να είναι κατάλληλη.

  3. Επαναλάβετε με ασφάλεια

    Για το POST /v1/maintenance-windows, στείλτε μια κεφαλίδα Idempotency-Key. Μετά από ένα αβέβαιο αποτέλεσμα, επαναλάβετε το ίδιο κλειδί και σώμα για να ανακτήσετε το αρχικό παράθυρο αντί να δημιουργήσετε ένα αντίγραφο. Ένα τροποποιημένο σώμα με το ίδιο κλειδί απορρίπτεται. Το DELETE /v1/maintenance-windows/{windowId} ακυρώνει ένα παράθυρο.

  4. Ακολουθήστε τις αποδείξεις ενέργειας

    Οι εγγραφές αυτοματισμού και διαχείρισης χρησιμοποιούν το idempotencyKey στο σώμα JSON και επιστρέφουν μια απόδειξη λειτουργίας. Το Completed σημαίνει ότι ο χειριστής αιτημάτων ολοκλήρωσε. Ελέγξτε το αποτέλεσμα ή την εκτέλεση τομέα για να μάθετε εάν η συσκευή ολοκλήρωσε την εργασία. Για το OutcomeUnknown, ελέγξτε την απόδειξη και την τρέχουσα κατάσταση πριν αποφασίσετε τι να κάνετε. Ποτέ μην στέλνετε ξανά αυτόματα με νέο κλειδί: η ενέργεια μπορεί να εκτελεστεί δύο φορές.

Αναφορά API →

Αναθεώρηση περιεχομένου 3f225a253 · OpenAPI SHA-256: b12c42306a89