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
GET	/assets/summary	Aggregierte Flottenzahlen abrufen: Gesamtzahlen, eine Statusaufschlüsselung und eine Zusammenfassung des Sicherheitsstatus
GET	/assets/{id}/commands	Die neuesten an ein Gerät gesendeten Befehle auflisten

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: 50, max.: 100)
sort	Sortierfeld und Richtung (z.B. syncedAt,desc)
lastSeenBefore	Nur Assets, die zuletzt vor diesem ISO-8601-Zeitpunkt gesehen wurden, z. B. 2026-01-01T00:00:00Z. Er darf nicht in der Zukunft oder vor 1970-01-01T00:00:00Z liegen. Wird auch von /assets/count unterstützt.

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/count

Asset abrufen

Gibt detaillierte Informationen zu einem bestimmten Asset anhand seiner ID zurück, einschließlich aller verschachtelten Objekte.

GET /assets/{id}

Geräte finden, die kürzlich nicht gesehen wurden

lastSeenBefore schränkt eine Liste oder eine Zählung auf Geräte ein, deren Datensatz zuletzt vor dem angegebenen Zeitpunkt aktualisiert wurde; dies ist eine praktische Möglichkeit, Offline-Geräte zu finden. Die Funktion arbeitet minutengenau, sodass ein Gerät, das bis zu 59 Sekunden nach dem Zeitpunkt aktualisiert wurde, möglicherweise noch enthalten ist.

curl "https://api.nomid.tech/emm/api/v1/assets?lastSeenBefore=2026-09-01T00:00:00Z&status=ACTIVE" \
  -H "X-API-Key: $NOMID_API_KEY"

Flottenzusammenfassung

GET /assets/summary erfordert DEVICES_READ und gibt ausschließlich aggregierte Zahlen zurück, niemals eine Geräteliste.

totalDevices	Gesamtzahl der Geräte.
devicesByStatus	Gerätezahlen nach Status aufgeschlüsselt.
securityPosture	Sicherheitszahlen wie secureCount, atRiskCount und potentiallyCompromisedCount. riskyDeviceIds listet bis zu 10 Gerätepfadnamen auf, die schwerwiegendsten zuerst. riskyDeviceCount ist die tatsächliche Gesamtzahl, und riskyDeviceIdsTruncated gibt an, ob die Liste gekürzt wurde.

Die Zählungen des Sicherheitsstatus schließen Pico-Geräte aus. Das übergeordnete totalDevices schließt sie nicht aus.

Befehlsverlauf

GET /assets/ASSET_ID/commands erfordert DEVICES_READ und gibt die neuesten an ein Gerät gesendeten Befehle zurück, die neuesten zuerst. limit ist standardmäßig 20 und ist auf 50 begrenzt. Ein limit unter 1 gibt 400 zurück, und ein unbekanntes Asset gibt 404 zurück.

type	Der Befehlstyp, zum Beispiel LOCK oder NOTIFICATION_MESSAGE.
status	IN_PROGRESS, EXPIRED, SUCCESS oder ERROR.
createdAt	Wann der Befehl erstellt wurde.
feedbackAt	Wann das Gerät oder der Anbieter sich zurückgemeldet hat, falls dies geschehen ist.
outcome	Ein kurzer Code, der den Status ERROR oder EXPIRED erklärt.

curl "https://api.nomid.tech/emm/api/v1/assets/k3x9m2pa/commands?limit=5" \
  -H "X-API-Key: $NOMID_API_KEY"

Befehlsnutzdaten und vertrauliche Daten werden niemals zurückgegeben.

Befehle mit der Gerätebefehls-API senden

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	Eindeutige Asset-Kennung: ein kurzer Code wie k3x9m2pa ohne Schrägstriche. Verwenden Sie ihn als Asset-ID in URLs, beispielsweise /assets/k3x9m2pa.
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: