Οδηγός Γρήγορης Εκκίνησης

Προαπαιτούμενα

• Ένας λογαριασμός Nomid MDM με δικαιώματα διαχειριστή
• Πρόσβαση στις Ρυθμίσεις Εταιρείας στην Πύλη
• Ένα εργαλείο για την πραγματοποίηση αιτημάτων HTTP (curl, Postman ή η προτιμώμενη γλώσσα σας)

Βήμα 1: Δημιουργία κλειδιού API

1. Συνδεθείτε στην Πύλη Nomid στη διεύθυνση portal.nomid.tech
2. Μεταβείτε στις Ρυθμίσεις Εταιρείας > Ενσωματώσεις
3. Κάντε κλικ στο 'Δημιουργία κλειδιού API' και δώστε του ένα περιγραφικό όνομα
4. Αντιγράψτε το κλειδί API - θα εμφανιστεί μόνο μία φορά!

Βήμα 2: Κάντε το πρώτο σας αίτημα

Χρησιμοποιήστε το κλειδί API σας για να ελέγξετε την ταυτότητα των αιτημάτων. Συμπεριλάβετε το στην κεφαλίδα X-API-Key:

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

Βήμα 3: Διαχειριστείτε την απόκριση

Το API επιστρέφει αποκρίσεις JSON. Ακολουθεί ένα παράδειγμα απόκρισης από το τελικό σημείο των συσκευών:

{
  "content": [{
    "pathName": "k3x9m2pa",
    "identification": "Warehouse-Scanner-01",
    "status": "ACTIVE",
    "syncedAt": "2026-01-20T14:22:00Z"
  }],
  "totalElements": 1,
  "totalPages": 1,
  "size": 20,
  "number": 0
}

Οι αποκρίσεις είναι σε σελίδες. Χρησιμοποιήστε τις παραμέτρους ερωτήματος 'page' και 'size' για να περιηγηθείτε στα αποτελέσματα.

Όρια ρυθμού αιτημάτων

Τα τελικά σημεία ανάγνωσης REST δεν εφαρμόζουν όριο ανά κλειδί στην εφαρμογή Nomid, αλλά δομήστε το πρόγραμμα-πελάτη σας ώστε να υποχωρεί σε σφάλμα 429 ούτως ή άλλως. Το τελικό σημείο MCP επιτρέπει 60 αιτήματα ανά λεπτό ανά κλειδί. Οι εντολές συσκευών, οι αλλαγές πολιτικής (κάθε κλήση propose και apply) και οι κωδικοί QR παροχής μοιράζονται ένα όριο εγγραφής 10 ανά λεπτό ανά κλειδί, σε όλα τα τελικά σημεία REST και τα εργαλεία MCP. Μια σύνδεση Sign in with Nomid έχει τα ίδια όρια MCP και εγγραφής, τα οποία υπολογίζονται ανά σύνδεση.

Το API δεν στέλνει κεφαλίδες X-RateLimit-Limit, X-RateLimit-Remaining ή X-RateLimit-Reset.

Επόμενα Βήματα