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. |
|---|---|
| status | IN_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 εντολών και τα ευαίσθητα δεδομένα δεν επιστρέφονται ποτέ.
Σχήμα Απόκρισης
Κάθε αντικείμενο περιουσιακού στοιχείου ακολουθεί τη δομή 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: