Assets API
Endpunkte für den Zugriff auf Asset-Informationen in Ihrem Unternehmen. Assets stellen Inventargegenstände dar, die möglicherweise als verwaltete Geräte registriert sind oder auch nicht.
Verfügbare Endpunkte
| Methode | Endpunkt | Beschreibung |
|---|---|---|
| GET | /assets | Alle Assets mit Paginierung und Filterung auflisten |
| GET | /assets/count | Gesamtanzahl der Assets abrufen |
| GET | /assets/{id} | Details eines bestimmten Assets abrufen |
Assets auflisten
Gibt eine paginierte Liste von Assets mit optionaler Filterung zurück. Die Ergebnisse werden standardmäßig nach syncedAt absteigend sortiert.
Abfrageparameter
| Feld | Beschreibung |
|---|---|
| status | Nach Asset-Status filtern (z.B. ACTIVE, INACTIVE) |
| policy | Filtern nach zugewiesenem Richtlinienpfadnamen |
| page | Seitennummer (0-indiziert, Standard: 0) |
| size | Seitengröße (Standard: 20, Maximum: 100) |
| sort | Sortierfeld und Richtung (z.B. syncedAt,desc) |
curl "https://api.nomid.tech/emm/api/v1/assets?page=0&size=20" \
-H "X-API-Key: nm_acme_abc123..."Asset-Anzahl abrufen
Gibt die Gesamtzahl der Assets zurück, die den Filterkriterien entsprechen. Unterstützt dieselben Filterparameter wie der Listenendpunkt.
GET /assets/countAsset abrufen
Gibt detaillierte Informationen zu einem bestimmten Asset anhand seiner ID zurück, einschließlich aller verschachtelten Objekte.
GET /assets/{id}Antwortschema
Jedes Asset-Objekt folgt der PublicAssetDto-Struktur mit verschachtelten Objekten für benutzerdefinierte Daten, Hardware-Spezifikationen und verwaltete Geräteinformationen.
Felder auf oberster Ebene
| pathName | Vollständiger Asset-Pfad in der Hierarchie (z. B. enterprises/acme/assets/asset_abc123) |
| identification | Benutzerfreundlicher Bezeichner oder Anzeigename für das Asset |
| status | Aktueller Asset-Status (ACTIVE, INACTIVE usw.) |
| syncedAt | ISO 8601 Zeitstempel der letzten Synchronisierung |
| customData | Objekt, das benutzerdefinierte Metadaten und Tags enthält |
| specifications | Objekt, das Hardware-Spezifikationen enthält |
| managedDevice | Objekt, das EMM-Geräteinformationen enthält, oder null, wenn nicht registriert |
customData Objekt
Schlüssel-Wert-Paare für benutzerdefinierte Metadaten (z. B. Abteilung, Standort)
Array von String-Tags zur Kategorisierung
specifications Objekt
Geräte-Seriennummer
Geräte-Modellname
Verwaltetes Geräteobjekt
Dieses Objekt ist null, wenn das Asset nicht als verwaltetes Gerät im EMM-System registriert ist.
Paginierung
Listen-Endpunkte geben paginierte Ergebnisse im Spring Page-Format zurück: