Πώς λειτουργεί το API

Τύποι κλήσης API

Οι τύποι κλήσης API GET, POST και DELETE είναι διαθέσιμοι στο ESET PROTECT On-Prem API.

•Οι κλήσεις GET περιέχουν οποιεσδήποτε παραμέτρους εισόδου (δεν έχουν σώμα) και στέλνουν δεδομένα απευθείας στη διεύθυνση URL. Η κλήση αιτήματος δεν μπορεί να τροποποιηθεί, μόνο εκτελείται.

•Οι κλήσεις POST απαιτούν ένα σώμα αιτήματος – οι παράμετροι τεκμηριώνονται για κάθε κλήση POST.

•Σε αιτήματα API που περιλαμβάνουν τη σελιδοποίηση (page_size), το προεπιλεγμένο μέγεθος σελίδας είναι 100 και το μέγιστο μέγεθος είναι 10000.

Κάθε κλήση αποτελείται από τα ακόλουθα στοιχεία:

•Τύπος κλήσης

•Διεύθυνση URL αιτήματος

•Κεφαλίδα αιτήματος (μπορεί να αποτελείται από το σύμβολο ελέγχου ταυτότητας)

•Σώμα αιτήματος (περιέχει δεδομένα, ειδικά με κλήσεις POST)

Δομή απόκρισης διακομιστή

Κάθε κλήση API λαμβάνει μια απόκριση από τον διακομιστή REST. Η απόκριση αποτελείται από τον κωδικό απόκρισης διακομιστή και την απόκριση μορφοποιημένη ως δεδομένα στο JSON.

Η απόκριση αποτελείται από τα παρακάτω στοιχεία:

•Κωδικός διακομιστή

•Σώμα απόκρισης

•Κεφαλίδες απόκρισης

Παραδείγματα κλήσεων API

GET

Εμφάνιση μιας πολιτικής (Το Policy_UUID λαμβάνεται από την Κονσόλα διαδικτύου.):

POST

Μετακινήστε τη συσκευή σε μια συγκεκριμένη στατική ομάδα (Το αναγνωριστικό υπολογιστή περιλαμβάνεται στη διεύθυνση URL.):