Punkt końcowy zasobów BI
Uzyskaj dostęp do danych zasobów w spłaszczonym formacie zoptymalizowanym dla narzędzi Business Intelligence. Wszystkie pola znajdują się na najwyższym poziomie, co ułatwia bezpośrednie mapowanie kolumn.
Dostępne punkty końcowe
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /bi/v1/assets | Lista wszystkich zasobów w spłaszczonym formacie |
| GET | /bi/v1/assets/count | Uzyskaj całkowitą liczbę zasobów |
| GET | /bi/v1/assets/{id} | Uzyskaj konkretny zasób według ID |
Lista wszystkich zasobów
Zwraca stronicowaną listę zasobów ze wszystkimi polami spłaszczonymi do poziomu głównego. Idealne do masowego eksportu danych do narzędzi BI.
Parametry zapytania
| status | Filtruj według statusu zasobu (np. AKTYWNY, NIEAKTYWNY) |
| policy | Filtruj według nazwy ścieżki przypisanej polityki |
| page | Numer strony (indeksowany od 0, domyślnie: 0) |
| size | Rozmiar strony (domyślnie: 20, maks.: 100) |
| sort | Pole sortowania i kierunek (np. lastSyncAt,desc) |
curl "https://api.nomid.tech/emm/api/bi/v1/assets?page=0&size=100" \
-H "X-API-Key: nm_acme_abc123..."Pobierz liczbę zasobów
Zwraca całkowitą liczbę zasobów pasujących do kryteriów filtrowania. Przydatne do obliczeń paginacji.
GET /bi/v1/assets/countUzyskaj konkretny zasób
Zwraca pojedynczy zasób w spłaszczonym formacie według jego identyfikatora.
GET /bi/v1/assets/{id}Schemat BiAssetDto
Każdy obiekt zasobu podąża za płaską strukturą BiAssetDto. Wszystkie pola są ciągami znaków na poziomie głównym - brak zagnieżdżonych obiektów lub tablic.
| Pole | Opis |
|---|---|
| pathName | Pełna ścieżka zasobu (np. enterprises/acme/assets/abc123) |
| identification | Przyjazny identyfikator zasobu |
| name | Nazwa urządzenia |
| description | Opis urządzenia |
| serialNumber | Numer seryjny urządzenia |
| imeis | Numery IMEI (rozdzielone przecinkami, jeśli jest ich wiele) |
| brand | Producent/marka urządzenia |
| model | Nazwa modelu urządzenia |
| status | Status zasobu (AKTYWNY, NIEAKTYWNY) |
| lastSyncAt | Znacznik czasu ostatniej synchronizacji (ISO 8601) |
| enrollmentTime | Znacznik czasu rejestracji urządzenia (ISO 8601) |
| policyPathName | Pełna ścieżka przypisanej polityki |
| policyDisplayName | Czytelna dla człowieka nazwa polityki |
| policyGroupName | Grupa polityk do kategoryzacji |
| metadata | Niestandardowe metadane jako ciąg znaków JSON |
| tags | Tagi jako ciąg znaków oddzielony przecinkami |
| operatingSystem | Nazwa systemu operacyjnego (np. Android) |
| operatingSystemVersion | Numer wersji systemu operacyjnego |
Public API vs BI API
Główna różnica polega na strukturze odpowiedzi. Public API wykorzystuje zagnieżdżone obiekty do organizacji, podczas gdy BI API spłaszcza wszystko dla łatwego mapowania kolumn.
Paginacja
Wyniki są stronicowane przy użyciu tego samego formatu co Public API. Użyj parametrów page i size, aby nawigować po dużych zbiorach danych.