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

MetodaPunkt końcowyOpis
GET/assetsWyświetl wszystkie zasoby z paginacją i filtrowaniem
GET/assets/countPobierz całkowitą liczbę zasobów
GET/assets/{id}Pobierz szczegóły konkretnego zasobu
GET/assets/summaryPobierz zagregowane dane floty: łączne sumy, zestawienie według stanu oraz podsumowanie stanu bezpieczeństwa
GET/assets/{id}/commandsWyś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

PoleOpis
statusFiltruj według statusu zasobu (np. AKTYWNY, NIEAKTYWNY)
policyFiltruj według nazwy ścieżki przypisanej zasady
pageNumer strony (indeksowany od 0, domyślnie: 0)
sizeRozmiar strony (domyślnie: 50, maks.: 100)
sortPole sortowania i kierunek (np. syncedAt,desc)
lastSeenBeforeTylko 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/count

Pobierz 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ń.

totalDevicesCałkowita liczba urządzeń.
devicesByStatusLiczby urządzeń z podziałem na statusy.
securityPostureWskaź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.

typeTyp polecenia, na przykład LOCK lub NOTIFICATION_MESSAGE.
statusIN_PROGRESS, EXPIRED, SUCCESS lub ERROR.
createdAtData i godzina utworzenia polecenia.
feedbackAtKiedy urządzenie lub dostawca przesłał raport zwrotny, jeśli to nastąpiło.
outcomeKró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.

Wysyłaj komendy za pomocą interfejsu API komend urządzeń

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

pathNameUnikalny 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.
identificationPrzyjazny dla użytkownika identyfikator lub nazwa wyświetlana zasobu
statusAktualny status zasobu (AKTYWNY, NIEAKTYWNY itp.)
syncedAtZnacznik czasu ostatniej synchronizacji w formacie ISO 8601
customDataObiekt zawierający niestandardowe metadane i tagi
specificationsObiekt zawierający specyfikacje sprzętu
managedDeviceObiekt 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:

Wybierz swój czas

Ładowanie...
Otwórz kalendarz rezerwacji