API Περιουσιακών Στοιχείων

Σημεία πρόσβασης για την ανάκτηση πληροφοριών στοιχείων στον οργανισμό σας. Τα στοιχεία αντιπροσωπεύουν στοιχεία αποθέματος που μπορεί να είναι ή να μην είναι εγγεγραμμένα ως διαχειριζόμενες συσκευές.

Διαθέσιμα Σημεία Πρόσβασης

GET/api/v1/assets

Λίστα όλων των στοιχείων με σελιδοποίηση και φιλτράρισμα

GET/api/v1/assets/count

Λήψη συνολικού αριθμού περιουσιακών στοιχείων

GET/api/v1/assets/{assetId}

Λήψη λεπτομερειών ενός συγκεκριμένου περιουσιακού στοιχείου

GET/api/v1/assets

Επιστρέφει μια σελιδοποιημένη λίστα στοιχείων με προαιρετικό φιλτράρισμα. Τα αποτελέσματα ταξινομούνται κατά syncedAt φθίνουσα εξ ορισμού.

Παράμετροι Ερωτήματος

Name	Type	Required	Description
`status`	string	Optional	Φιλτράρισμα κατά την κατάσταση του στοιχείου (π.χ., ACTIVE, INACTIVE)
`policy`	string	Optional	Φιλτράρισμα κατά όνομα διαδρομής πολιτικής που έχει ανατεθεί
`page`	integer	Optional	Αριθμός σελίδας (με βάση το 0, προεπιλογή: 0)(default: `0`)
`size`	integer	Optional	Μέγεθος σελίδας (προεπιλογή: 20, μέγιστο: 100)(default: `20`)
`sort`	string	Optional	Πεδίο και κατεύθυνση ταξινόμησης (π.χ. 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

Επιστρέφει τον συνολικό αριθμό των περιουσιακών στοιχείων που ταιριάζουν με τα κριτήρια φιλτραρίσματος. Υποστηρίζει τις ίδιες παραμέτρους φιλτραρίσματος με το τελικό σημείο λίστας.

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}

Επιστρέφει λεπτομερείς πληροφορίες σχετικά με ένα συγκεκριμένο περιουσιακό στοιχείο με το ID του, συμπεριλαμβανομένων όλων των ένθετων αντικειμένων.

Request

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

Σχήμα Απόκρισης

Κάθε αντικείμενο περιουσιακού στοιχείου ακολουθεί τη δομή PublicAssetDto με ένθετα αντικείμενα για προσαρμοσμένα δεδομένα, προδιαγραφές υλικού και πληροφορίες διαχειριζόμενης συσκευής.

Πεδία Κορυφαίου Επιπέδου

Name	Type	Required	Description
`pathName`	string	Required	Πλήρης διαδρομή του περιουσιακού στοιχείου στην ιεραρχία (π.χ., enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Φιλικό προς τον χρήστη αναγνωριστικό ή όνομα εμφάνισης για το περιουσιακό στοιχείο
`status`	string	Required	Τρέχουσα κατάσταση του περιουσιακού στοιχείου (ACTIVE, INACTIVE, κ.λπ.)
`syncedAt`	string	Required	Χρονική σήμανση ISO 8601 τελευταίου συγχρονισμού
`customData`	object	Optional	Αντικείμενο που περιέχει προσαρμοσμένα μεταδεδομένα και ετικέτες
`specifications`	object	Optional	Αντικείμενο που περιέχει προδιαγραφές υλικού
`managedDevice`	object \| null	Optional	Αντικείμενο που περιέχει πληροφορίες συσκευής EMM, ή null εάν δεν έχει εγγραφεί

Αντικείμενο customData

Name	Type	Required	Description
`metadata`	object	Optional	Ζεύγη κλειδιού-τιμής προσαρμοσμένων μεταδεδομένων (π.χ. τμήμα, τοποθεσία)
`tags`	string[]	Optional	Σειρά από ετικέτες συμβολοσειρών για κατηγοριοποίηση

Αντικείμενο specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Σειρά από αριθμούς IMEI συσκευών
`serialNumber`	string	Optional	Σειριακός αριθμός συσκευής
`model`	string	Optional	Όνομα μοντέλου συσκευής
`brand`	string	Optional	Κατασκευαστής/μάρκα συσκευής
`os`	string	Optional	Όνομα λειτουργικού συστήματος (π.χ. Android)
`osVersion`	string	Optional	Έκδοση λειτουργικού συστήματος

Αντικείμενο managedDevice

Αυτό το αντικείμενο είναι null όταν το στοιχείο δεν είναι εγγεγραμμένο ως διαχειριζόμενη συσκευή στο σύστημα EMM.

Name	Type	Required	Description
`pathName`	string	Required	Διαδρομή συσκευής στο σύστημα EMM
`name`	string	Required	Όνομα εμφάνισης συσκευής στο EMM
`status`	string	Required	Κατάσταση συσκευής EMM (ACTIVE, PROVISIONING, DISABLED, κ.λπ.)
`policyPathName`	string	Required	Διαδρομή της εκχωρημένης πολιτικής
`enrollmentTime`	string	Required	Χρονοσφραγίδα ISO 8601 όταν εγγράφηκε η συσκευή

Σελίδα

Οι τελικές σημεία λίστας επιστρέφουν αποτελέσματα σε σελίδες χρησιμοποιώντας τη μορφή Page του Spring:

content - Πίνακας αντικειμένων στοιχείων για την τρέχουσα σελίδα
totalElements - Συνολικός αριθμός στοιχείων που ταιριάζουν με την αναζήτηση
totalPages - Συνολικός αριθμός διαθέσιμων σελίδων
size - Ζητούμενο μέγεθος σελίδας
number - Τρέχων αριθμός σελίδας (ξεκινώντας από 0)

Σημείωση

Το μέγιστο μέγεθος σελίδας είναι 100. Αιτήματα με μέγεθος > 100 θα περιοριστούν σε 100.

API Περιουσιακών Στοιχείων

Διαθέσιμα Σημεία Πρόσβασης

GET/api/v1/assets

Λίστα όλων των στοιχείων με σελιδοποίηση και φιλτράρισμα

GET/api/v1/assets/count

Λήψη συνολικού αριθμού περιουσιακών στοιχείων

GET/api/v1/assets/{assetId}

Λήψη λεπτομερειών ενός συγκεκριμένου περιουσιακού στοιχείου

GET/api/v1/assets

Παράμετροι Ερωτήματος

Name	Type	Required	Description
`status`	string	Optional	Φιλτράρισμα κατά την κατάσταση του στοιχείου (π.χ., ACTIVE, INACTIVE)
`policy`	string	Optional	Φιλτράρισμα κατά όνομα διαδρομής πολιτικής που έχει ανατεθεί
`page`	integer	Optional	Αριθμός σελίδας (με βάση το 0, προεπιλογή: 0)(default: `0`)
`size`	integer	Optional	Μέγεθος σελίδας (προεπιλογή: 20, μέγιστο: 100)(default: `20`)
`sort`	string	Optional	Πεδίο και κατεύθυνση ταξινόμησης (π.χ. 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

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}

Request

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

Σχήμα Απόκρισης

Πεδία Κορυφαίου Επιπέδου

Name	Type	Required	Description
`pathName`	string	Required	Πλήρης διαδρομή του περιουσιακού στοιχείου στην ιεραρχία (π.χ., enterprises/acme/assets/asset_abc123)
`identification`	string	Required	Φιλικό προς τον χρήστη αναγνωριστικό ή όνομα εμφάνισης για το περιουσιακό στοιχείο
`status`	string	Required	Τρέχουσα κατάσταση του περιουσιακού στοιχείου (ACTIVE, INACTIVE, κ.λπ.)
`syncedAt`	string	Required	Χρονική σήμανση ISO 8601 τελευταίου συγχρονισμού
`customData`	object	Optional	Αντικείμενο που περιέχει προσαρμοσμένα μεταδεδομένα και ετικέτες
`specifications`	object	Optional	Αντικείμενο που περιέχει προδιαγραφές υλικού
`managedDevice`	object \| null	Optional	Αντικείμενο που περιέχει πληροφορίες συσκευής EMM, ή null εάν δεν έχει εγγραφεί

Αντικείμενο customData

Name	Type	Required	Description
`metadata`	object	Optional	Ζεύγη κλειδιού-τιμής προσαρμοσμένων μεταδεδομένων (π.χ. τμήμα, τοποθεσία)
`tags`	string[]	Optional	Σειρά από ετικέτες συμβολοσειρών για κατηγοριοποίηση

Αντικείμενο specifications

Name	Type	Required	Description
`imeis`	string[]	Optional	Σειρά από αριθμούς IMEI συσκευών
`serialNumber`	string	Optional	Σειριακός αριθμός συσκευής
`model`	string	Optional	Όνομα μοντέλου συσκευής
`brand`	string	Optional	Κατασκευαστής/μάρκα συσκευής
`os`	string	Optional	Όνομα λειτουργικού συστήματος (π.χ. Android)
`osVersion`	string	Optional	Έκδοση λειτουργικού συστήματος

Αντικείμενο managedDevice

Name	Type	Required	Description
`pathName`	string	Required	Διαδρομή συσκευής στο σύστημα EMM
`name`	string	Required	Όνομα εμφάνισης συσκευής στο EMM
`status`	string	Required	Κατάσταση συσκευής EMM (ACTIVE, PROVISIONING, DISABLED, κ.λπ.)
`policyPathName`	string	Required	Διαδρομή της εκχωρημένης πολιτικής
`enrollmentTime`	string	Required	Χρονοσφραγίδα ISO 8601 όταν εγγράφηκε η συσκευή

Σελίδα

Οι τελικές σημεία λίστας επιστρέφουν αποτελέσματα σε σελίδες χρησιμοποιώντας τη μορφή Page του Spring:

content - Πίνακας αντικειμένων στοιχείων για την τρέχουσα σελίδα
totalElements - Συνολικός αριθμός στοιχείων που ταιριάζουν με την αναζήτηση
totalPages - Συνολικός αριθμός διαθέσιμων σελίδων
size - Ζητούμενο μέγεθος σελίδας
number - Τρέχων αριθμός σελίδας (ξεκινώντας από 0)

Σημείωση

Το μέγιστο μέγεθος σελίδας είναι 100. Αιτήματα με μέγεθος > 100 θα περιοριστούν σε 100.