API Περιουσιακών Στοιχείων
Σημεία πρόσβασης για την ανάκτηση πληροφοριών στοιχείων στον οργανισμό σας. Τα στοιχεία αντιπροσωπεύουν στοιχεία αποθέματος που μπορεί να είναι ή να μην είναι εγγεγραμμένα ως διαχειριζόμενες συσκευές.
Διαθέσιμα Σημεία Πρόσβασης
| Μέθοδος | Σημείο Πρόσβασης | Περιγραφή |
|---|---|---|
| GET | /assets | Λίστα όλων των στοιχείων με σελιδοποίηση και φιλτράρισμα |
| GET | /assets/count | Λήψη συνολικού αριθμού περιουσιακών στοιχείων |
| GET | /assets/{id} | Λήψη λεπτομερειών ενός συγκεκριμένου περιουσιακού στοιχείου |
Λίστα Στοιχείων
Επιστρέφει μια σελιδοποιημένη λίστα στοιχείων με προαιρετικό φιλτράρισμα. Τα αποτελέσματα ταξινομούνται κατά syncedAt φθίνουσα εξ ορισμού.
Παράμετροι Ερωτήματος
| Πεδίο | Περιγραφή |
|---|---|
| status | Φιλτράρισμα κατά την κατάσταση του στοιχείου (π.χ., ACTIVE, INACTIVE) |
| policy | Φιλτράρισμα κατά όνομα διαδρομής πολιτικής που έχει ανατεθεί |
| page | Αριθμός σελίδας (με βάση το 0, προεπιλογή: 0) |
| size | Μέγεθος σελίδας (προεπιλογή: 20, μέγιστο: 100) |
| sort | Πεδίο και κατεύθυνση ταξινόμησης (π.χ. syncedAt,desc) |
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}Σχήμα Απόκρισης
Κάθε αντικείμενο περιουσιακού στοιχείου ακολουθεί τη δομή PublicAssetDto με ένθετα αντικείμενα για προσαρμοσμένα δεδομένα, προδιαγραφές υλικού και πληροφορίες διαχειριζόμενης συσκευής.
Πεδία Κορυφαίου Επιπέδου
| pathName | Πλήρης διαδρομή του περιουσιακού στοιχείου στην ιεραρχία (π.χ., enterprises/acme/assets/asset_abc123) |
| identification | Φιλικό προς τον χρήστη αναγνωριστικό ή όνομα εμφάνισης για το περιουσιακό στοιχείο |
| status | Τρέχουσα κατάσταση του περιουσιακού στοιχείου (ACTIVE, INACTIVE, κ.λπ.) |
| syncedAt | Χρονική σήμανση ISO 8601 τελευταίου συγχρονισμού |
| customData | Αντικείμενο που περιέχει προσαρμοσμένα μεταδεδομένα και ετικέτες |
| specifications | Αντικείμενο που περιέχει προδιαγραφές υλικού |
| managedDevice | Αντικείμενο που περιέχει πληροφορίες συσκευής EMM, ή null εάν δεν έχει εγγραφεί |
Αντικείμενο customData
Ζεύγη κλειδιού-τιμής προσαρμοσμένων μεταδεδομένων (π.χ. τμήμα, τοποθεσία)
Σειρά από ετικέτες συμβολοσειρών για κατηγοριοποίηση
Αντικείμενο specifications
Σειριακός αριθμός συσκευής
Όνομα μοντέλου συσκευής
Αντικείμενο managedDevice
Αυτό το αντικείμενο είναι null όταν το στοιχείο δεν είναι εγγεγραμμένο ως διαχειριζόμενη συσκευή στο σύστημα EMM.
Σελίδα
Οι τελικές σημεία λίστας επιστρέφουν αποτελέσματα σε σελίδες χρησιμοποιώντας τη μορφή Page του Spring: