Οδηγός Γρήγορης Εκκίνησης
Ξεκινήστε γρήγορα με το API Nomid MDM σε λίγα μόλις λεπτά. Αυτός ο οδηγός θα σας καθοδηγήσει στη ρύθμιση της πιστοποίησης και στην πραγματοποίηση της πρώτης σας κλήσης API.
Προαπαιτούμενα
- Ένας λογαριασμός Nomid MDM με δικαιώματα διαχειριστή
- Πρόσβαση στις Ρυθμίσεις Εταιρείας στην Πύλη
- Ένα εργαλείο για την πραγματοποίηση αιτημάτων HTTP (curl, Postman ή η προτιμώμενη γλώσσα σας)
Βήμα 1: Δημιουργία κλειδιού API
- Συνδεθείτε στην Πύλη Nomid στη διεύθυνση portal.nomid.tech
- Μεταβείτε στις Ρυθμίσεις Εταιρείας > Ενσωματώσεις
- Κάντε κλικ στο 'Δημιουργία κλειδιού API' και δώστε του ένα περιγραφικό όνομα
- Αντιγράψτε το κλειδί API - θα εμφανιστεί μόνο μία φορά!
Σημαντικό
Αποθηκεύστε με ασφάλεια το κλειδί API σας. Θα εμφανιστεί μόνο μία φορά κατά τη δημιουργία του. Αν το χάσετε, θα πρέπει να δημιουργήσετε ένα νέο.
Βήμα 2: Κάντε το πρώτο σας αίτημα
Χρησιμοποιήστε το κλειδί API σας για να ελέγξετε την ταυτότητα των αιτημάτων. Συμπεριλάβετε το στην κεφαλίδα X-API-Key:
curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
-H "X-API-Key: nm_acme_abc123..."Tip
You can test these examples directly in your terminal or browser console. Make sure to replace the API key with your own.
Βήμα 3: Διαχειριστείτε την απόκριση
Το API επιστρέφει αποκρίσεις JSON. Ακολουθεί ένα παράδειγμα απόκρισης από το τελικό σημείο των συσκευών:
Responsejson
{
"content": [
{
"pathName": "enterprises/acme/assets/asset_123abc",
"identification": "Warehouse-Scanner-01",
"status": "ACTIVE",
"syncedAt": "2026-01-20T14:22:00Z",
"customData": {
"metadata": { "department": "Warehouse", "location": "Building A" },
"tags": ["scanner", "warehouse"]
},
"specifications": {
"imeis": ["123456789012345"],
"serialNumber": "ABC123456",
"model": "TC52",
"brand": "Zebra",
"os": "Android",
"osVersion": "13"
},
"managedDevice": {
"pathName": "enterprises/acme/devices/device_123abc",
"name": "devices/device_123abc",
"status": "ACTIVE",
"policyPathName": "enterprises/acme/policies/warehouse",
"enrollmentTime": "2026-01-15T10:30:00Z"
}
}
],
"totalElements": 1,
"totalPages": 1,
"size": 20,
"number": 0
}Οι αποκρίσεις είναι σε σελίδες. Χρησιμοποιήστε τις παραμέτρους ερωτήματος 'page' και 'size' για να περιηγηθείτε στα αποτελέσματα.
Όρια αιτημάτων
Το API περιλαμβάνει κεφαλίδες ορίου αιτημάτων σε κάθε απόκριση. Παρακολουθήστε τις για να αποφύγετε την υπέρβαση των ορίων.
| Header | Περιγραφή |
|---|---|
| X-RateLimit-Limit | Μέγιστος αριθμός αιτημάτων ανά λεπτό |
| X-RateLimit-Remaining | Αιτήματα που απομένουν στο τρέχον παράθυρο |
| X-RateLimit-Reset | Χρονοσφραγίδα Unix όταν επαναφέρεται το όριο ρυθμού |