Έλεγχος Ταυτότητας

Επισκόπηση

Τα κλειδιά API χρησιμοποιούνται για τον έλεγχο ταυτότητας όλων των αιτημάτων στο Nomid MDM API. Συμπεριλάβετε το κλειδί API σας στην κεφαλίδα X-API-Key με κάθε αίτημα.

X-API-Key: nm_acme_a1b2c3d4e5f6...

Λήψη του Κλειδιού API σας

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

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

• Ένας λογαριασμός Nomid MDM με πρόσβαση διαχειριστή
• Πρόσβαση στις Ρυθμίσεις Εταιρείας στην Πύλη Nomid

1. 1

   Συνδεθείτε στην Πύλη Nomid

   Ανοίξτε το πρόγραμμα περιήγησής σας και μεταβείτε στην Πύλη Nomid. Συνδεθείτε με τα διαπιστευτήριά σας ως διαχειριστής.

2. 2

   Μεταβείτε στις Ενσωματώσεις

   Αφού συνδεθείτε, μεταβείτε στην ενότητα Ρυθμίσεις Εταιρείας και επιλέξτε την καρτέλα Ενσωματώσεις.

3. 3

   Κάντε κλικ στο Δημιουργία Κλειδιού API

   Κάντε κλικ στο κουμπί "Δημιουργία Κλειδιού API" που βρίσκεται στην επάνω δεξιά γωνία της σελίδας Ενσωματώσεις.

4. 4

   Εισάγετε ένα Όνομα

   Στο αναδυόμενο παράθυρο που εμφανίζεται, εισαγάγετε ένα περιγραφικό όνομα για το κλειδί API σας. Αυτό σας βοηθά να αναγνωρίσετε το κλειδί αργότερα (π.χ., "Ενσωμάτωση Power BI" ή "Συγχρονισμός CRM").

5. 5

   Αντιγράψτε το Κλειδί σας

   Μετά το κλικ στο Δημιουργία, το κλειδί API σας θα εμφανιστεί. Κάντε κλικ στο κουμπί Αντιγραφή για να το αντιγράψετε στο πρόχειρο. Το κλειδί θα εμφανιστεί μόνο μία φορά!

Μορφή Κλειδιού API

Τα κλειδιά API ακολουθούν αυτήν τη μορφή:

nm_{company}_{random_32_chars}

• Όλα τα κλειδιά ξεκινούν με 'nm_
• Πρόθεμα ειδικό για την εταιρεία για αναγνώριση
• 32 τυχαίοι χαρακτήρες για ασφάλεια

Χρήση του Κλειδιού API σας

Συμπεριλάβετε το κλειδί API στην κεφαλίδα X-API-Key με κάθε αίτημα:

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

Βέλτιστες πρακτικές ασφαλείας

• Μην εκθέτετε ποτέ κλειδιά API σε κώδικα από την πλευρά του πελάτη ή σε δημόσια αποθετήρια
• Περιστρέψτε τα κλειδιά τακτικά και ανακαλέστε τα αχρησιμοποίητα κλειδιά
• Αποθηκεύστε τα κλειδιά σε μεταβλητές περιβάλλοντος, όχι σε κώδικα
• Χρησιμοποιήστε τις ελάχιστες απαραίτητες άδειες για την ενσωμάτωσή σας

Σφάλματα Επαλήθευσης

Το API επιστρέφει συγκεκριμένους κωδικούς σφάλματος για ζητήματα επαλήθευσης: