Loading...
API integracji BI
API Integracji BI zapewnia znormalizowane eksporty danych zoptymalizowane pod kątem narzędzi Business Intelligence. Uzyskaj dostęp do danych urządzeń i zasobów w formacie łatwym do zaimportowania do Power BI, Tableau, Excel i innych platform analitycznych.
Podstawowy adres URL:
https://api.nomid.tech/emm/api/bi/v1Dlaczego osobne API?
Narzędzia Business Intelligence często mają problemy ze zagnieżdżonymi strukturami JSON. API BI rozwiązuje ten problem, udostępniając te same dane w znormalizowanym formacie.
Publiczne API (/api/v1)
- Zagnieżdżone DTO dla bogatych relacji obiektów
- Idealne do tworzenia aplikacji
- Wiele poziomów hierarchii obiektów
API BI (/api/bi/v1)
- Wszystkie właściwości spłaszczone do najwyższego poziomu
- Bezpośrednie mapowanie kolumn dla narzędzi BI
- Te same dane, zoptymalizowana struktura
Porównanie formatów odpowiedzi
Te same dane zasobu są zwracane w różnych formatach w zależności od używanego API.
Publiczne API /api/v1
Zagnieżdżona strukturajson
{
"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
Spłaszczona strukturajson
{
"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"
}Dostępne punkty końcowe
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /assets | Lista wszystkich zasobów (spłaszczone DTO) |
| GET | /assets/count | Uzyskaj łączną liczbę zasobów |
| GET | /assets/{assetId} | Uzyskaj konkretny zasób (spłaszczone DTO) |
Uwierzytelnianie
Interfejs API BI wykorzystuje to samo uwierzytelnianie kluczem API co Public API. Dołącz swój klucz API w nagłówku X-API-Key przy każdym żądaniu.
X-API-Key: nm_acme_abc123...
Typowe przypadki użycia
Pulpity nawigacyjne Power BI
Raporty Tableau
Połączenia danych Excel
Niestandardowe potoki analityczne
Rozpocznij
Zapoznaj się z pełną dokumentacją punktu końcowego zasobów BI wraz z przykładami kodu i schematami odpowiedzi.
Dokumentacja zasobów BI