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

GET/api/v1/assets

Wyświetl wszystkie zasoby z paginacją i filtrowaniem

GET/api/v1/assets/count

Pobierz całkowitą liczbę zasobów

GET/api/v1/assets/{assetId}

Pobierz szczegóły konkretnego zasobu

GET/api/v1/assets

Zwraca paginowaną listę zasobów z opcjonalnym filtrowaniem. Wyniki są domyślnie sortowane według syncedAt malejąco.

Parametry zapytania

Name	Type	Required	Description
`status`	string	Optional	Filtruj według statusu zasobu (np. AKTYWNY, NIEAKTYWNY)
`policy`	string	Optional	Filtruj według nazwy ścieżki przypisanej polityki
`page`	integer	Optional	Numer strony (indeksowany od 0, domyślnie: 0)(default: `0`)
`size`	integer	Optional	Rozmiar strony (domyślnie: 20, maks.: 100)(default: `20`)
`sort`	string	Optional	Pole sortowania i kierunek (np. syncedAt,desc)

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets?status=ACTIVE&page=0&size=20" \
  -H "X-API-Key: nm_acme_abc123..."

Responsejson

{
  "content": [
    {
      "pathName": "enterprises/acme/assets/asset_abc123",
      "identification": "Warehouse Scanner 01",
      "status": "ACTIVE",
      "syncedAt": "2026-01-29T08:15:00Z",
      "customData": {
        "metadata": {
          "department": "logistics",
          "location": "warehouse-a"
        },
        "tags": ["warehouse", "scanner", "critical"]
      },
      "specifications": {
        "imeis": ["123456789012345"],
        "serialNumber": "ABC123XYZ",
        "model": "Galaxy Tab Active3",
        "brand": "Samsung",
        "os": "Android",
        "osVersion": "13"
      },
      "managedDevice": {
        "pathName": "enterprises/acme/devices/device_xyz789",
        "name": "Warehouse Scanner 01",
        "status": "ACTIVE",
        "policyPathName": "enterprises/acme/policies/warehouse",
        "enrollmentTime": "2025-01-15T10:30:00Z"
      }
    }
  ],
  "totalElements": 156,
  "totalPages": 8,
  "size": 20,
  "number": 0
}

GET/api/v1/assets/count

Zwraca całkowitą liczbę zasobów pasujących do kryteriów filtrowania. Obsługuje te same parametry filtrowania co punkt końcowy listy.

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets/count?status=ACTIVE" \
  -H "X-API-Key: nm_acme_abc123..."

Responsejson

{
  "count": 156
}

GET/api/v1/assets/{assetId}

Zwraca szczegółowe informacje o konkretnym zasobie według jego identyfikatora, w tym wszystkie zagnieżdżone obiekty.

Request

curl -X GET "https://api.nomid.tech/emm/api/v1/assets/asset_abc123" \
  -H "X-API-Key: nm_acme_abc123..."

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

Name	Type	Required	Description
`pathName`	string	Required	Pełna ścieżka zasobu w hierarchii (np. enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Przyjazny dla użytkownika identyfikator lub nazwa wyświetlana zasobu
`status`	string	Required	Aktualny status zasobu (AKTYWNY, NIEAKTYWNY itp.)
`syncedAt`	string	Required	Znacznik czasu ostatniej synchronizacji w formacie ISO 8601
`customData`	object	Optional	Obiekt zawierający niestandardowe metadane i tagi
`specifications`	object	Optional	Obiekt zawierający specyfikacje sprzętu
`managedDevice`	object \| null	Optional	Obiekt zawierający informacje o urządzeniu EMM lub null, jeśli nie jest zarejestrowane

Obiekt customData

Name	Type	Required	Description
`metadata`	object	Optional	Pary klucz-wartość niestandardowych metadanych (np. dział, lokalizacja)
`tags`	string[]	Optional	Tablica tagów tekstowych do kategoryzacji

Obiekt specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Tablica numerów IMEI urządzeń
`serialNumber`	string	Optional	Numer seryjny urządzenia
`model`	string	Optional	Nazwa modelu urządzenia
`brand`	string	Optional	Producent/marka urządzenia
`os`	string	Optional	Nazwa systemu operacyjnego (np. Android)
`osVersion`	string	Optional	Wersja systemu operacyjnego

Obiekt managedDevice

Ten obiekt jest pusty, gdy zasób nie jest zarejestrowany jako zarządzane urządzenie w systemie EMM.

Name	Type	Required	Description
`pathName`	string	Required	Ścieżka urządzenia w systemie EMM
`name`	string	Required	Nazwa wyświetlana urządzenia w EMM
`status`	string	Required	Status urządzenia EMM (ACTIVE, PROVISIONING, DISABLED itp.)
`policyPathName`	string	Required	Ścieżka przypisanej polityki
`enrollmentTime`	string	Required	Znacznik czasu w formacie ISO 8601, kiedy urządzenie zostało zarejestrowane

Paginacja

Listowe punkty końcowe zwracają spaginowane wyniki w formacie Page systemu Spring:

content - Tablica obiektów zasobów dla bieżącej strony
totalElements - Całkowita liczba zasobów pasujących do zapytania
totalPages - Całkowita liczba dostępnych stron
size - Żądany rozmiar strony
number - Aktualny numer strony (indeksowany od 0)

Uwaga

Maksymalny rozmiar strony to 100. Żądania o rozmiarze > 100 zostaną ograniczone do 100.

Name

Type

Required

Description

status

string

Optional

Filtruj według statusu zasobu (np. AKTYWNY, NIEAKTYWNY)

policy

string

Optional

Filtruj według nazwy ścieżki przypisanej polityki

page

integer

Optional

Numer strony (indeksowany od 0, domyślnie: 0)(default: 0)

size

integer

Optional

Rozmiar strony (domyślnie: 20, maks.: 100)(default: 20)

sort

string

Optional

Pole sortowania i kierunek (np. syncedAt,desc)

{ "content": [ { "pathName": "enterprises/acme/assets/asset_abc123", "identification": "Warehouse Scanner 01", "status": "ACTIVE", "syncedAt": "2026-01-29T08:15:00Z", "customData": { "metadata": { "department": "logistics", "location": "warehouse-a" }, "tags": ["warehouse", "scanner", "critical"] }, "specifications": { "imeis": ["123456789012345"], "serialNumber": "ABC123XYZ", "model": "Galaxy Tab Active3", "brand": "Samsung", "os": "Android", "osVersion": "13" }, "managedDevice": { "pathName": "enterprises/acme/devices/device_xyz789", "name": "Warehouse Scanner 01", "status": "ACTIVE", "policyPathName": "enterprises/acme/policies/warehouse", "enrollmentTime": "2025-01-15T10:30:00Z" } } ], "totalElements": 156, "totalPages": 8, "size": 20, "number": 0 }

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

Name	Type	Required	Description
`pathName`	string	Required	Pełna ścieżka zasobu w hierarchii (np. enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Przyjazny dla użytkownika identyfikator lub nazwa wyświetlana zasobu
`status`	string	Required	Aktualny status zasobu (AKTYWNY, NIEAKTYWNY itp.)
`syncedAt`	string	Required	Znacznik czasu ostatniej synchronizacji w formacie ISO 8601
`customData`	object	Optional	Obiekt zawierający niestandardowe metadane i tagi
`specifications`	object	Optional	Obiekt zawierający specyfikacje sprzętu
`managedDevice`	object \| null	Optional	Obiekt zawierający informacje o urządzeniu EMM lub null, jeśli nie jest zarejestrowane

Obiekt customData

Name	Type	Required	Description
`metadata`	object	Optional	Pary klucz-wartość niestandardowych metadanych (np. dział, lokalizacja)
`tags`	string[]	Optional	Tablica tagów tekstowych do kategoryzacji

Obiekt specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Tablica numerów IMEI urządzeń
`serialNumber`	string	Optional	Numer seryjny urządzenia
`model`	string	Optional	Nazwa modelu urządzenia
`brand`	string	Optional	Producent/marka urządzenia
`os`	string	Optional	Nazwa systemu operacyjnego (np. Android)
`osVersion`	string	Optional	Wersja systemu operacyjnego

Obiekt managedDevice

Ten obiekt jest pusty, gdy zasób nie jest zarejestrowany jako zarządzane urządzenie w systemie EMM.

Name	Type	Required	Description
`pathName`	string	Required	Ścieżka urządzenia w systemie EMM
`name`	string	Required	Nazwa wyświetlana urządzenia w EMM
`status`	string	Required	Status urządzenia EMM (ACTIVE, PROVISIONING, DISABLED itp.)
`policyPathName`	string	Required	Ścieżka przypisanej polityki
`enrollmentTime`	string	Required	Znacznik czasu w formacie ISO 8601, kiedy urządzenie zostało zarejestrowane

Paginacja

Listowe punkty końcowe zwracają spaginowane wyniki w formacie Page systemu Spring:

content - Tablica obiektów zasobów dla bieżącej strony

totalElements - Całkowita liczba zasobów pasujących do zapytania

totalPages - Całkowita liczba dostępnych stron

size - Żądany rozmiar strony

number - Aktualny numer strony (indeksowany od 0)

Uwaga

Maksymalny rozmiar strony to 100. Żądania o rozmiarze > 100 zostaną ograniczone do 100.