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 |
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 polityki |
| page | Numer strony (indeksowany od 0, domyślnie: 0) |
| size | Rozmiar strony (domyślnie: 20, maks.: 100) |
| sort | Pole sortowania i kierunek (np. syncedAt,desc) |
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}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 | Pełna ścieżka zasobu w hierarchii (np. enterprises/acme/assets/asset_abc123) |
| 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: