Τελικό Σημείο BI Assets
Πρόσβαση σε δεδομένα στοιχείων σε επίπεδη μορφή βελτιστοποιημένη για εργαλεία Business Intelligence. Όλα τα πεδία βρίσκονται στο επίπεδο ρίζας για απευθείας αντιστοίχιση στηλών.
Διαθέσιμα Τελικά Σημεία
| Μέθοδος | Τελικό Σημείο | Περιγραφή |
|---|---|---|
| GET | /bi/v1/assets | Λίστα όλων των περιουσιακών στοιχείων σε απλοποιημένη μορφή |
| GET | /bi/v1/assets/count | Λήψη συνολικού αριθμού στοιχείων |
| GET | /bi/v1/assets/{id} | Λήψη συγκεκριμένου στοιχείου ανά ID |
Λίστα Όλων των Περιουσιακών Στοιχείων
Επιστρέφει μια αριθμημένη λίστα περιουσιακών στοιχείων με όλα τα πεδία απλοποιημένα στο επίπεδο ρίζας. Ιδανικό για μαζική εξαγωγή δεδομένων σε εργαλεία BI.
Παράμετροι Ερωτήματος
| status | Φιλτράρισμα κατά κατάσταση περιουσιακού στοιχείου (π.χ., ΕΝΕΡΓΟ, ΑΝΕΝΕΡΓΟ) |
| policy | Φιλτράρισμα κατά όνομα διαδρομής εκχωρημένης πολιτικής |
| page | Αριθμός σελίδας (με βάση το 0, προεπιλογή: 0) |
| size | Μέγεθος σελίδας (προεπιλογή: 20, μέγιστο: 100) |
| sort | Πεδίο και κατεύθυνση ταξινόμησης (π.χ., lastSyncAt,desc) |
curl "https://api.nomid.tech/emm/api/bi/v1/assets?page=0&size=100" \
-H "X-API-Key: nm_acme_abc123..."Λήψη Αριθμού Περιουσιακών Στοιχείων
Επιστρέφει τον συνολικό αριθμό στοιχείων που ταιριάζουν με τα κριτήρια φίλτρου. Χρήσιμο για υπολογισμούς σελιδοποίησης.
GET /bi/v1/assets/countΛήψη Συγκεκριμένου Στοιχείου
Επιστρέφει ένα μεμονωμένο στοιχείο σε επίπεδη μορφή με βάση το ID του στοιχείου.
GET /bi/v1/assets/{id}Σχήμα BiAssetDto
Κάθε αντικείμενο στοιχείου ακολουθεί την επίπεδη δομή BiAssetDto. Όλα τα πεδία είναι συμβολοσειρές στο βασικό επίπεδο - χωρίς ένθετα αντικείμενα ή πίνακες.
| Πεδίο | Περιγραφή |
|---|---|
| pathName | Πλήρης διαδρομή περιουσιακού στοιχείου (π.χ., enterprises/acme/assets/abc123) |
| identification | Αναγνωριστικό φιλικό προς τον χρήστη για το περιουσιακό στοιχείο |
| name | Όνομα Συσκευής |
| description | Περιγραφή Συσκευής |
| serialNumber | Σειριακός αριθμός συσκευής |
| imeis | Αριθμοί IMEI (διαχωρισμένοι με κόμμα αν είναι πολλαπλοί) |
| brand | Κατασκευαστής/μάρκα συσκευής |
| model | Όνομα μοντέλου συσκευής |
| status | Κατάσταση συσκευής (ΕΝΕΡΓΗ, ΑΝΕΝΕΡΓΗ) |
| lastSyncAt | Χρονοσφραγίδα τελευταίου συγχρονισμού (ISO 8601) |
| enrollmentTime | Χρονοσφραγίδα εγγραφής συσκευής (ISO 8601) |
| policyPathName | Πλήρης διαδρομή ανατεθειμένης πολιτικής |
| policyDisplayName | Όνομα πολιτικής σε αναγνώσιμη μορφή |
| policyGroupName | Ομάδα πολιτικής για κατηγοριοποίηση |
| metadata | Προσαρμοσμένα μεταδεδομένα ως συμβολοσειρά JSON |
| tags | Ετικέτες ως συμβολοσειρά χωρισμένη με κόμμα |
| operatingSystem | Όνομα λειτουργικού συστήματος (π.χ. Android) |
| operatingSystemVersion | Αριθμός έκδοσης λειτουργικού συστήματος |
Δημόσιο API έναντι BI API
Η κύρια διαφορά είναι η δομή της απόκρισης. Το Δημόσιο API χρησιμοποιεί ένθετα αντικείμενα για την οργάνωση, ενώ το BI API τα ισοπεδώνει για εύκολη αντιστοίχιση στηλών.
Υποσελίδωση
Τα αποτελέσματα υποσελιδώνονται χρησιμοποιώντας την ίδια μορφή με το Δημόσιο API. Χρησιμοποιήστε τις παραμέτρους page και size για να περιηγηθείτε σε μεγάλα σύνολα δεδομένων.