Πώς να δημιουργήσετε ένα κλειδί API ventic;

Ένα κλειδί API απαιτείται για τον έλεγχο ταυτότητας των αιτημάτων για ενοποίηση με την πλατφόρμα ventic. Αυτά τα κλειδιά είναι μοναδικά για τον οργανισμό σας και παρέχουν ασφαλή πρόσβαση στον κατάλογο προϊόντων και τις εμπορικές υπηρεσίες σας.

Δείτε πώς να διαχειριστείτε το κλειδί API σας:

1. Πρόσβαση στον πίνακα προγραμματιστών

Συνδεθείτε στον λογαριασμό σας στη ventic και μεταβείτε στην ενότητα Settings > Developers. Εκεί θα βρείτε μια καρτέλα με το όνομα "API Keys".

2. Δημιουργία νέου κλειδιού

Για να δημιουργήσετε ένα νέο κλειδί:

1. Κάντε κλικ στο κουμπί “Create API Key”.
2. Δώστε στο κλειδί ένα περιγραφικό όνομα (π.χ. "Production - Main Store" ή "Testing - Nikos").
3. Επιλέξτε το εύρος των δικαιωμάτων (Scopes). Συνιστούμε να εκχωρείτε στα κλειδιά μόνο τα απαραίτητα δικαιώματα (αρχή του ελάχιστου προνομίου).
4. Κάντε κλικ στο “Generate”.

3. Ασφαλής αποθήκευση του κλειδιού

Μετά τη δημιουργία, το κλειδί θα σας εμφανιστεί μόνο μία φορά.

• Σημαντικό: Αντιγράψτε το κλειδί και αποθηκεύστε το σε ασφαλές μέρος (π.χ. διαχειριστή κωδικών πρόσβασης ή ασφαλές θησαυροφυλάκιο κλειδιών στο σύστημά σας).
• Σημείωση: Για λόγους ασφαλείας, η ventic δεν θα εμφανίσει ξανά ολόκληρο το κλειδί μετά το κλείσιμο του παραθύρου.

4. Χρήση του κλειδιού στα αιτήματα

Όλα τα αιτήματα που αποστέλλονται στη διεπαφή API της ventic πρέπει να περιλαμβάνουν το κλειδί API στην κεφαλίδα HTTP X-API-Key.

Παράδειγμα χρήσης με cURL:

curl -X GET "https://api.ventic.ai/v1/products" \
     -H "X-API-Key: your_api_key_here" \
     -H "Accept: application/json"

5. Εναλλαγή και ανάκληση κλειδιού

Εάν υποψιάζεστε ότι το κλειδί σας έχει διαρρεύσει, θα πρέπει να το ανακαλέσετε αμέσως.

• Στον πίνακα ελέγχου, επιλέξτε το κλειδί που θέλετε να καταργήσετε και κάντε κλικ στο “Revoke” (Ανάκληση).
• Μετά την ανάκληση, οποιοδήποτε αίτημα χρησιμοποιεί αυτό το κλειδί θα απορρίπτεται.
• Δημιουργήστε ένα νέο κλειδί και ενημερώστε τη διαμόρφωση του συστήματός σας.

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

• Ποτέ μην δημοσιεύετε κλειδιά API στον πηγαίο κώδικα (π.χ. στο GitHub). Χρησιμοποιήστε μεταβλητές περιβάλλοντος (environment variables).
• Χρησιμοποιήστε ξεχωριστά κλειδιά για περιβάλλοντα δοκιμών (testing) και παραγωγής (production).
• Ελέγχετε τακτικά τη λίστα των ενεργών κλειδιών και αφαιρείτε αυτά που δεν χρησιμοποιούνται πλέον.

Εάν χρειάζεστε βοήθεια για την ενοποίηση, επικοινωνήστε με την τεχνική ομάδα μας στο support@ventic.ai.