Loading...
API Ενοποίησης BI
Το BI Integration API παρέχει εξαγωγές δεδομένων σε επίπεδη μορφή, βελτιστοποιημένες για εργαλεία Business Intelligence. Πρόσβαση σε δεδομένα συσκευών και περιουσιακών στοιχείων σε μορφή που είναι εύκολη στην εισαγωγή στο Power BI, Tableau, Excel και άλλες πλατφόρμες ανάλυσης.
Βασική διεύθυνση URL:
https://api.nomid.tech/emm/api/bi/v1Γιατί ξεχωριστό API;
Τα εργαλεία Business Intelligence συχνά δυσκολεύονται με φωλιασμένες δομές JSON. Το BI API λύνει αυτό παρέχοντας τα ίδια δεδομένα σε επίπεδη μορφή.
Δημόσιο API (/api/v1)
- Φωλιασμένα DTO για πλούσιες σχέσεις αντικειμένων
- Ιδανικό για ανάπτυξη εφαρμογών
- Πολλά επίπεδα ιεραρχίας αντικειμένων
BI API (/api/bi/v1)
- Όλες οι ιδιότητες σε επίπεδη μορφή στο ανώτατο επίπεδο
- Άμεση αντιστοίχιση στηλών για εργαλεία BI
- Ίδια δεδομένα, βελτιστοποιημένη δομή
Σύγκριση Μορφών Απόκρισης
Τα ίδια δεδομένα στοιχείων επιστρέφονται σε διαφορετικές μορφές ανάλογα με το ποιο API χρησιμοποιείτε.
Δημόσιο API /api/v1
Ένθετη Δομήjson
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"status": "ACTIVE",
"syncedAt": "2026-01-29T08:15:00Z",
"customData": {
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"model": "Galaxy Tab Active3",
"brand": "Samsung"
},
"managedDevice": {
"pathName": "enterprises/acme/devices/device_xyz789",
"status": "ACTIVE",
"policyPathName": "enterprises/acme/policies/warehouse"
}
}API BI /api/bi/v1
Επίπεδη Δομήjson
{
"pathName": "enterprises/acme/assets/asset_abc123",
"identification": "Warehouse Scanner 01",
"status": "ACTIVE",
"lastSyncAt": "2026-01-29T08:15:00Z",
"metadata": { "department": "logistics" },
"tags": ["warehouse", "scanner"],
"imeis": ["123456789012345"],
"serialNumber": "ABC123XYZ",
"model": "Galaxy Tab Active3",
"brand": "Samsung",
"policyPathName": "enterprises/acme/policies/warehouse",
"policyDisplayName": "Warehouse Policy",
"policyGroupName": "Logistics"
}Διαθέσιμα Τελικά Σημεία
| Μέθοδος | Σημείο Τερματισμού | Περιγραφή |
|---|---|---|
| GET | /assets | Λίστα όλων των στοιχείων (ισοπεδοποιημένο DTO) |
| GET | /assets/count | Λήψη συνολικού αριθμού στοιχείων |
| GET | /assets/{assetId} | Λήψη συγκεκριμένου στοιχείου (ισοπεδοποιημένο DTO) |
Έλεγχος Ταυτότητας
Το BI API χρησιμοποιεί τον ίδιο έλεγχο ταυτότητας κλειδιού API με το Public API. Συμπεριλάβετε το κλειδί API σας στην κεφαλίδα X-API-Key με κάθε αίτημα.
X-API-Key: nm_acme_abc123...
Συνήθεις Περιπτώσεις Χρήσης
Πίνακες Ελέγχου Power BI
Αναφορές Tableau
Συνδέσεις Δεδομένων Excel
Προσαρμοσμένες Διοχετεύσεις Ανάλυσης
Ξεκινήστε
Δείτε την πλήρη τεκμηρίωση του τελικού σημείου BI Assets με παραδείγματα κώδικα και σχήματα απόκρισης.
Τεκμηρίωση BI Assets