API zasobów
Punkty końcowe do uzyskiwania dostępu do informacji o zasobach w Twojej organizacji. Zasoby reprezentują pozycje z inwentarza, które mogą być lub nie być zarejestrowane jako zarządzane urządzenia.
Dostępne punkty końcowe
| Metoda | Punkt końcowy | Opis |
|---|---|---|
| GET | /assets | Wyświetl wszystkie zasoby z paginacją i filtrowaniem |
| GET | /assets/count | Pobierz całkowitą liczbę zasobów |
| GET | /assets/{id} | Pobierz szczegóły konkretnego zasobu |
| GET | /assets/summary | Pobierz zagregowane dane floty: łączne sumy, zestawienie według stanu oraz podsumowanie stanu bezpieczeństwa |
| GET | /assets/{id}/commands | Wyświetl listę ostatnich poleceń wysłanych do urządzenia |
Lista zasobów
Zwraca paginowaną listę zasobów z opcjonalnym filtrowaniem. Wyniki są domyślnie sortowane według syncedAt malejąco.
Parametry zapytania
| Pole | Opis |
|---|---|
| status | Filtruj według statusu zasobu (np. AKTYWNY, NIEAKTYWNY) |
| policy | Filtruj według nazwy ścieżki przypisanej zasady |
| page | Numer strony (indeksowany od 0, domyślnie: 0) |
| size | Rozmiar strony (domyślnie: 50, maks.: 100) |
| sort | Pole sortowania i kierunek (np. syncedAt,desc) |
| lastSeenBefore | Tylko zasoby ostatnio widziane przed tą chwilą w formacie ISO-8601, na przykład 2026-01-01T00:00:00Z. Wartość nie może być w przyszłości ani przed 1970-01-01T00:00:00Z. Obsługiwane również przez /assets/count. |
curl "https://api.nomid.tech/emm/api/v1/assets?page=0&size=20" \
-H "X-API-Key: nm_acme_abc123..." Pobierz liczbę zasobów
Zwraca całkowitą liczbę zasobów pasujących do kryteriów filtrowania. Obsługuje te same parametry filtrowania co punkt końcowy listy.
GET /assets/countPobierz zasób
Zwraca szczegółowe informacje o konkretnym zasobie według jego identyfikatora, w tym wszystkie zagnieżdżone obiekty.
GET /assets/{id}Znajdź urządzenia niewidziane od niedawna
Parametr lastSeenBefore zawęża listę lub liczbę do urządzeń, których rekord był ostatnio aktualizowany przed podaną chwilą, co stanowi praktyczny sposób na znalezienie urządzeń offline. Działa z dokładnością do minuty, więc urządzenie zaktualizowane do 59 sekund po tej chwili może nadal zostać uwzględnione.
curl "https://api.nomid.tech/emm/api/v1/assets?lastSeenBefore=2026-09-01T00:00:00Z&status=ACTIVE" \
-H "X-API-Key: $NOMID_API_KEY" Podsumowanie floty
GET /assets/summary wymaga uprawnienia DEVICES_READ i zwraca wyłącznie zagregowane liczby, nigdy listę urządzeń.
| totalDevices | Całkowita liczba urządzeń. |
|---|---|
| devicesByStatus | Liczby urządzeń z podziałem na statusy. |
| securityPosture | Wskaźniki bezpieczeństwa, takie jak secureCount, atRiskCount i potentiallyCompromisedCount. riskyDeviceIds zawiera listę do 10 nazw ścieżek urządzeń, od najbardziej zagrożonych. riskyDeviceCount to rzeczywista łączna liczba, a riskyDeviceIdsTruncated informuje, czy lista została ucięta. |
Wskaźniki stanu bezpieczeństwa wykluczają urządzenia Pico. Wartość totalDevices najwyższego poziomu ich nie wyklucza.
Historia poleceń
GET /assets/ASSET_ID/commands wymaga uprawnienia DEVICES_READ i zwraca najnowsze polecenia wysłane do urządzenia, zaczynając od najnowszych. Parametr limit wynosi domyślnie 20 i ma maksymalną wartość 50. Wartość limit poniżej 1 zwraca błąd 400, a nieznany zasób zwraca błąd 404.
| type | Typ polecenia, na przykład LOCK lub NOTIFICATION_MESSAGE. |
|---|---|
| status | IN_PROGRESS, EXPIRED, SUCCESS lub ERROR. |
| createdAt | Data i godzina utworzenia polecenia. |
| feedbackAt | Kiedy urządzenie lub dostawca przesłał raport zwrotny, jeśli to nastąpiło. |
| outcome | Krótki kod wyjaśniający status ERROR lub EXPIRED. |
curl "https://api.nomid.tech/emm/api/v1/assets/k3x9m2pa/commands?limit=5" \
-H "X-API-Key: $NOMID_API_KEY" Ładunki komend (payloads) i dane poufne nigdy nie są zwracane.
Schemat odpowiedzi
Każdy obiekt zasobu ma strukturę PublicAssetDto z zagnieżdżonymi obiektami dla niestandardowych danych, specyfikacji sprzętu i informacji o zarządzanym urządzeniu.
Pola najwyższego poziomu
| pathName | Unikalny identyfikator zasobu: krótki kod, np. k3x9m2pa, bez ukośników. Używaj go jako identyfikatora zasobu (asset ID) w adresach URL, na przykład /assets/k3x9m2pa. |
| identification | Przyjazny dla użytkownika identyfikator lub nazwa wyświetlana zasobu |
| status | Aktualny status zasobu (AKTYWNY, NIEAKTYWNY itp.) |
| syncedAt | Znacznik czasu ostatniej synchronizacji w formacie ISO 8601 |
| customData | Obiekt zawierający niestandardowe metadane i tagi |
| specifications | Obiekt zawierający specyfikacje sprzętu |
| managedDevice | Obiekt zawierający informacje o urządzeniu EMM lub null, jeśli nie jest zarejestrowane |
Obiekt customData
Pary klucz-wartość niestandardowych metadanych (np. dział, lokalizacja)
Tablica tagów tekstowych do kategoryzacji
Obiekt specifications
Numer seryjny urządzenia
Nazwa modelu urządzenia
Obiekt managedDevice
Ten obiekt jest pusty, gdy zasób nie jest zarejestrowany jako zarządzane urządzenie w systemie EMM.
Paginacja
Listowe punkty końcowe zwracają spaginowane wyniki w formacie Page systemu Spring: