Τελικό Σημείο BI Assets
Πρόσβαση σε δεδομένα στοιχείων σε επίπεδη μορφή βελτιστοποιημένη για εργαλεία Business Intelligence. Όλα τα πεδία βρίσκονται στο επίπεδο ρίζας για απευθείας αντιστοίχιση στηλών.
Βασική Διαφορά από το Δημόσιο API
Το API της BI επιστρέφει μια εντελώς επίπεδη δομή - χωρίς ένθετα αντικείμενα. Αυτό το καθιστά ιδανικό για εργαλεία που αναμένουν δεδομένα σε μορφή πίνακα:
- •Όλα τα πεδία είναι σε κορυφαίο επίπεδο (χωρίς ένθεση)
- •Οι πίνακες μετατρέπονται σε συμβολοσειρές διαχωρισμένες με κόμμα
- •Τα αντικείμενα σειριοποιούνται ως συμβολοσειρές JSON
Διαθέσιμα Τελικά Σημεία
| Μέθοδος | Τελικό Σημείο | Περιγραφή |
|---|---|---|
| GET | /api/bi/v1/assets | Λίστα όλων των περιουσιακών στοιχείων σε απλοποιημένη μορφή |
| GET | /api/bi/v1/assets/count | Λήψη συνολικού αριθμού στοιχείων |
| GET | /api/bi/v1/assets/{assetId} | Λήψη συγκεκριμένου στοιχείου ανά ID |
/assetsΛίστα Όλων των Περιουσιακών Στοιχείων
Επιστρέφει μια αριθμημένη λίστα περιουσιακών στοιχείων με όλα τα πεδία απλοποιημένα στο επίπεδο ρίζας. Ιδανικό για μαζική εξαγωγή δεδομένων σε εργαλεία BI.
Παράμετροι Ερωτήματος
| Parameter | Type | Description |
|---|---|---|
| status | string | Φιλτράρισμα κατά κατάσταση περιουσιακού στοιχείου (π.χ., ΕΝΕΡΓΟ, ΑΝΕΝΕΡΓΟ) |
| policy | string | Φιλτράρισμα κατά όνομα διαδρομής εκχωρημένης πολιτικής |
| page | integer | Αριθμός σελίδας (με βάση το 0, προεπιλογή: 0) |
| size | integer | Μέγεθος σελίδας (προεπιλογή: 20, μέγιστο: 100) |
| sort | string | Πεδίο και κατεύθυνση ταξινόμησης (π.χ., lastSyncAt,desc) |
curl -X GET "https://api.nomid.tech/emm/api/bi/v1/assets?status=ACTIVE&page=0&size=100" \
-H "X-API-Key: nm_acme_abc123..."{
"content": [
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"name": "WH-SCANNER-001",
"description": "Main warehouse barcode scanner",
"serialNumber": "ABC123XYZ",
"imeis": "123456789012345",
"brand": "Samsung",
"model": "Galaxy Tab Active3",
"status": "ACTIVE",
"lastSyncAt": "2026-01-29T08:15:00Z",
"enrollmentTime": "2025-01-15T10:30:00Z",
"policyPathName": "enterprises/acme/policies/warehouse",
"policyDisplayName": "Warehouse Policy",
"policyGroupName": "Warehouse",
"metadata": "{\"department\":\"logistics\",\"location\":\"warehouse-a\"}",
"tags": "warehouse,scanner,critical",
"operatingSystem": "Android",
"operatingSystemVersion": "13"
}
],
"totalElements": 156,
"totalPages": 2,
"size": 100,
"number": 0
}/assets/countΛήψη Αριθμού Περιουσιακών Στοιχείων
Επιστρέφει τον συνολικό αριθμό στοιχείων που ταιριάζουν με τα κριτήρια φίλτρου. Χρήσιμο για υπολογισμούς σελιδοποίησης.
curl -X GET "https://api.nomid.tech/emm/api/bi/v1/assets/count?status=ACTIVE" \
-H "X-API-Key: nm_acme_abc123..."{
"count": 156
}/assets/{assetId}Λήψη Συγκεκριμένου Στοιχείου
Επιστρέφει ένα μεμονωμένο στοιχείο σε επίπεδη μορφή με βάση το ID του στοιχείου.
curl -X GET "https://api.nomid.tech/emm/api/bi/v1/assets/asset_abc123" \
-H "X-API-Key: nm_acme_abc123..."Σχήμα BiAssetDto
Κάθε αντικείμενο στοιχείου ακολουθεί την επίπεδη δομή BiAssetDto. Όλα τα πεδία είναι συμβολοσειρές στο βασικό επίπεδο - χωρίς ένθετα αντικείμενα ή πίνακες.
| Field | Type | Description |
|---|---|---|
| Αναγνωριστικά | ||
| pathName | string | Πλήρης διαδρομή περιουσιακού στοιχείου (π.χ., enterprises/acme/assets/abc123) |
| identification | string | Αναγνωριστικό φιλικό προς τον χρήστη για το περιουσιακό στοιχείο |
| name | string | Όνομα Συσκευής |
| description | string | Περιγραφή Συσκευής |
| Πληροφορίες Υλικού | ||
| serialNumber | string | Σειριακός αριθμός συσκευής |
| imeis | string | Αριθμοί IMEI (διαχωρισμένοι με κόμμα αν είναι πολλαπλοί) |
| brand | string | Κατασκευαστής/μάρκα συσκευής |
| model | string | Όνομα μοντέλου συσκευής |
| Κατάσταση & Χρονικές Σφραγίδες | ||
| status | string | Κατάσταση συσκευής (ΕΝΕΡΓΗ, ΑΝΕΝΕΡΓΗ) |
| lastSyncAt | string | Χρονοσφραγίδα τελευταίου συγχρονισμού (ISO 8601) |
| enrollmentTime | string | Χρονοσφραγίδα εγγραφής συσκευής (ISO 8601) |
| Πληροφορίες Πολιτικής | ||
| policyPathName | string | Πλήρης διαδρομή ανατεθειμένης πολιτικής |
| policyDisplayName | string | Όνομα πολιτικής σε αναγνώσιμη μορφή |
| policyGroupName | string | Ομάδα πολιτικής για κατηγοριοποίηση |
| Προσαρμοσμένα Δεδομένα | ||
| metadata | string | Προσαρμοσμένα μεταδεδομένα ως συμβολοσειρά JSON |
| tags | string | Ετικέτες ως συμβολοσειρά χωρισμένη με κόμμα |
| Λειτουργικό Σύστημα | ||
| operatingSystem | string | Όνομα λειτουργικού συστήματος (π.χ. Android) |
| operatingSystemVersion | string | Αριθμός έκδοσης λειτουργικού συστήματος |
Δημόσιο API έναντι BI API
Η κύρια διαφορά είναι η δομή της απόκρισης. Το Δημόσιο API χρησιμοποιεί ένθετα αντικείμενα για την οργάνωση, ενώ το BI API τα ισοπεδώνει για εύκολη αντιστοίχιση στηλών.
Δημόσιο API (Ένθετο)
// Public API Response (nested)
{
"pathName": "enterprises/acme/assets/abc123",
"customData": {
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"brand": "Samsung"
},
"managedDevice": {
"policyPathName": "enterprises/acme/policies/warehouse"
}
}BI API (Επίπεδο)
// BI API Response (flat)
{
"pathName": "enterprises/acme/assets/abc123",
"metadata": "{\"department\":\"logistics\"}",
"tags": "warehouse,scanner",
"imeis": "123456789012345",
"serialNumber": "ABC123XYZ",
"brand": "Samsung",
"policyPathName": "enterprises/acme/policies/warehouse"
}Υποσελίδωση
Τα αποτελέσματα υποσελιδώνονται χρησιμοποιώντας την ίδια μορφή με το Δημόσιο API. Χρησιμοποιήστε τις παραμέτρους page και size για να περιηγηθείτε σε μεγάλα σύνολα δεδομένων.
Συμβουλή: Για μαζικές εξαγωγές, χρησιμοποιήστε size=100 (μέγιστο) και επαναλάβετε όλες τις σελίδες. Τα παραπάνω παραδείγματα Power BI και Python δείχνουν πώς να ανακτήσετε αυτόματα όλες τις σελίδες.