API Περιουσιακών Στοιχείων

Σημεία πρόσβασης για την ανάκτηση πληροφοριών στοιχείων στον οργανισμό σας. Τα στοιχεία αντιπροσωπεύουν στοιχεία αποθέματος που μπορεί να είναι ή να μην είναι εγγεγραμμένα ως διαχειριζόμενες συσκευές.

Διαθέσιμα Σημεία Πρόσβασης

ΜέθοδοςΣημείο ΠρόσβασηςΠεριγραφή
GET/assetsΛίστα όλων των στοιχείων με σελιδοποίηση και φιλτράρισμα
GET/assets/countΛήψη συνολικού αριθμού περιουσιακών στοιχείων
GET/assets/{id}Λήψη λεπτομερειών ενός συγκεκριμένου περιουσιακού στοιχείου
GET/assets/summaryΛήψη συγκεντρωτικών αριθμών στόλου: σύνολα, ανάλυση κατάστασης και σύνοψη επιπέδου ασφαλείας
GET/assets/{id}/commandsΠροβολή των πιο πρόσφατων εντολών που στάλθηκαν σε μια συσκευή

Λίστα Στοιχείων

Επιστρέφει μια σελιδοποιημένη λίστα στοιχείων με προαιρετικό φιλτράρισμα. Τα αποτελέσματα ταξινομούνται κατά syncedAt φθίνουσα εξ ορισμού.

Παράμετροι Ερωτήματος

ΠεδίοΠεριγραφή
statusΦιλτράρισμα κατά την κατάσταση του στοιχείου (π.χ., ACTIVE, INACTIVE)
policyΦιλτράρισμα κατά όνομα διαδρομής πολιτικής που έχει ανατεθεί
pageΑριθμός σελίδας (με βάση το 0, προεπιλογή: 0)
sizeΜέγεθος σελίδας (προεπιλογή: 50, μέγ.: 100)
sortΠεδίο και κατεύθυνση ταξινόμησης (π.χ. syncedAt,desc)
lastSeenBeforeΜόνο πόροι που εντοπίστηκαν τελευταία φορά πριν από αυτήν τη χρονική στιγμή ISO-8601, για παράδειγμα 2026-01-01T00:00:00Z. Δεν πρέπει να είναι στο μέλλον ή πριν από 1970-01-01T00:00:00Z. Υποστηρίζεται επίσης από το /assets/count.
curl "https://api.nomid.tech/emm/api/v1/assets?page=0&size=20" \
  -H "X-API-Key: nm_acme_abc123..."

Λήψη Αριθμού Περιουσιακών Στοιχείων

Επιστρέφει τον συνολικό αριθμό των περιουσιακών στοιχείων που ταιριάζουν με τα κριτήρια φιλτραρίσματος. Υποστηρίζει τις ίδιες παραμέτρους φιλτραρίσματος με το τελικό σημείο λίστας.

GET /assets/count

Λήψη Περιουσιακού Στοιχείου

Επιστρέφει λεπτομερείς πληροφορίες σχετικά με ένα συγκεκριμένο περιουσιακό στοιχείο με το ID του, συμπεριλαμβανομένων όλων των ένθετων αντικειμένων.

GET /assets/{id}

Εύρεση συσκευών που δεν έχουν εντοπιστεί πρόσφατα

Το lastSeenBefore περιορίζει μια λίστα ή μια καταμέτρηση σε συσκευές των οποίων η εγγραφή ενημερώθηκε τελευταία φορά πριν από τη χρονική στιγμή που ορίζετε, κάτι που αποτελεί πρακτικό τρόπο για την εύρεση συσκευών εκτός σύνδεσης. Λειτουργεί με ακρίβεια λεπτού, επομένως μια συσκευή που ενημερώθηκε έως και 59 δευτερόλεπτα μετά τη χρονική στιγμή ενδέχεται να συμπεριληφθεί.

curl "https://api.nomid.tech/emm/api/v1/assets?lastSeenBefore=2026-09-01T00:00:00Z&status=ACTIVE" \
  -H "X-API-Key: $NOMID_API_KEY"

Σύνοψη στόλου

Το GET /assets/summary απαιτεί το DEVICES_READ και επιστρέφει μόνο συγκεντρωτικούς αριθμούς, ποτέ λίστα συσκευών.

totalDevicesΣυνολικός αριθμός συσκευών.
devicesByStatusΚαταμετρήσεις συσκευών ανά κατάσταση.
securityPostureΚαταμετρήσεις ασφαλείας όπως secureCount, atRiskCount και potentiallyCompromisedCount. Το riskyDeviceIds παραθέτει έως και 10 ονόματα διαδρομών συσκευών, ξεκινώντας από τη χειρότερη. Το riskyDeviceCount είναι το πραγματικό σύνολο και το riskyDeviceIdsTruncated δηλώνει εάν η λίστα περικόπηκε.

Οι καταμετρήσεις επιπέδου ασφαλείας εξαιρούν τις συσκευές Pico. Το totalDevices ανώτατου επιπέδου δεν τις εξαιρεί.

Ιστορικό εντολών

Το GET /assets/ASSET_ID/commands απαιτεί το DEVICES_READ και επιστρέφει τις πιο πρόσφατες εντολές που στάλθηκαν σε μια συσκευή, με τις νεότερες πρώτες. Το limit έχει προεπιλογή το 20 και μέγιστο όριο το 50. Ένα limit κάτω από 1 επιστρέφει 400 και ένας άγνωστος πόρος επιστρέφει 404.

typeΟ τύπος εντολής, για παράδειγμα LOCK ή NOTIFICATION_MESSAGE.
statusIN_PROGRESS, EXPIRED, SUCCESS ή ERROR.
createdAtΠότε δημιουργήθηκε η εντολή.
feedbackAtΠότε απέστειλε αναφορά η συσκευή ή ο πάροχος, εάν το έχει κάνει.
outcomeΈνας σύντομος κωδικός που εξηγεί μια κατάσταση ERROR ή EXPIRED.
curl "https://api.nomid.tech/emm/api/v1/assets/k3x9m2pa/commands?limit=5" \
  -H "X-API-Key: $NOMID_API_KEY"

Τα payload εντολών και τα ευαίσθητα δεδομένα δεν επιστρέφονται ποτέ.

Αποστολή εντολών με το API εντολών συσκευής

Σχήμα Απόκρισης

Κάθε αντικείμενο περιουσιακού στοιχείου ακολουθεί τη δομή PublicAssetDto με ένθετα αντικείμενα για προσαρμοσμένα δεδομένα, προδιαγραφές υλικού και πληροφορίες διαχειριζόμενης συσκευής.

Πεδία Κορυφαίου Επιπέδου

pathNameΜοναδικό αναγνωριστικό στοιχείου: ένας σύντομος κωδικός όπως k3x9m2pa, χωρίς καθέτους. Χρησιμοποιήστε το ως το asset ID σε URL, για παράδειγμα /assets/k3x9m2pa.
identificationΦιλικό προς τον χρήστη αναγνωριστικό ή όνομα εμφάνισης για το περιουσιακό στοιχείο
statusΤρέχουσα κατάσταση του περιουσιακού στοιχείου (ACTIVE, INACTIVE, κ.λπ.)
syncedAtΧρονική σήμανση ISO 8601 τελευταίου συγχρονισμού
customDataΑντικείμενο που περιέχει προσαρμοσμένα μεταδεδομένα και ετικέτες
specificationsΑντικείμενο που περιέχει προδιαγραφές υλικού
managedDeviceΑντικείμενο που περιέχει πληροφορίες συσκευής EMM, ή null εάν δεν έχει εγγραφεί

Αντικείμενο customData

Ζεύγη κλειδιού-τιμής προσαρμοσμένων μεταδεδομένων (π.χ. τμήμα, τοποθεσία)

Σειρά από ετικέτες συμβολοσειρών για κατηγοριοποίηση

Αντικείμενο specifications

Σειριακός αριθμός συσκευής

Όνομα μοντέλου συσκευής

Αντικείμενο managedDevice

Αυτό το αντικείμενο είναι null όταν το στοιχείο δεν είναι εγγεγραμμένο ως διαχειριζόμενη συσκευή στο σύστημα EMM.

Σελίδα

Οι τελικές σημεία λίστας επιστρέφουν αποτελέσματα σε σελίδες χρησιμοποιώντας τη μορφή Page του Spring:

Επιλέξτε την ώρα σας

Φόρτωση...
Άνοιγμα ημερολογίου κρατήσεων