Λογότυπο PeekHire
Αυτοματισμοί και προγραμματιστές

Κλειδιά API

Δημιουργήστε, ορίστε δικαιώματα και ανανεώστε τα κλειδιά που πιστοποιούν την πρόσβαση στο API.

Τα κλειδιά API πιστοποιούν την προγραμματική πρόσβαση στο PeekHire — τόσο στο REST API όσο και στους αυτοματισμούς no-code.

Δημιουργία κλειδιού

  1. Μεταβείτε στα Εργαλεία προγραμματιστών → Κλειδιά API → Δημιουργία.
  2. Δώστε στο κλειδί ένα περιγραφικό όνομα (π.χ. Zapier integration) ώστε να θυμάστε σε τι χρησιμεύει.
  3. Αντιγράψτε την τιμή του κλειδιού όταν εμφανιστεί — για λόγους ασφαλείας, δεν θα μπορείτε να τη δείτε ξανά αργότερα.

Χρήση κλειδιού

Στείλτε το κλειδί ως bearer token σε κάθε αίτημα:

curl https://your-api-host/api/v1/applications \
  -H "Authorization: Bearer YOUR_API_KEY"

Δικαιώματα

Κάθε κλειδί έχει δικαιώματα που περιορίζουν τι μπορεί να κάνει:

  • Ανάγνωση — ανάκτηση δεδομένων (λίστα και προβολή καμπανιών, αιτήσεων, χρηστών).
  • Εγγραφή — δημιουργία ή τροποποίηση δεδομένων.

Παραχωρήστε μόνο ό,τι χρειάζεται η ενσωμάτωση (ελάχιστα απαραίτητα δικαιώματα). Ένα κλειδί μόνο για ανάγνωση αρκεί για συγχρονισμό δεδομένων σε ένα υπολογιστικό φύλλο ή dashboard· προσθέστε Εγγραφή μόνο όταν η ενσωμάτωση πρέπει να αλλάξει κάτι στο PeekHire.

Διατήρηση της ασφάλειας των κλειδιών

  • Αντιμετωπίζετε τα κλειδιά σαν κωδικούς πρόσβασης. Όποιος έχει ένα κλειδί μπορεί να ενεργήσει στα δεδομένα σας.
  • Μην κάνετε ποτέ commit κλειδιά σε repository και μην τα βάζετε σε client-side κώδικα.
  • Χρησιμοποιείτε ξεχωριστό κλειδί για κάθε ενσωμάτωση, ώστε να μπορείτε να ανακαλέσετε ένα χωρίς να επηρεάσετε τα υπόλοιπα.
  • Αποθηκεύετε τα κλειδιά σε secrets manager ή στον χώρο αποθήκευσης διαπιστευτηρίων του εργαλείου σας, όχι σε απλό κείμενο.

Περιστροφή και ανάκληση

Αν ένα κλειδί εκτεθεί — ή αν απλώς περιστρέφετε τα κλειδιά βάσει προγράμματος — δημιουργήστε ένα νέο κλειδί, ενημερώστε την ενσωμάτωσή σας και μετά διαγράψτε το παλιό. Η διαγραφή ενός κλειδιού ανακαλεί την πρόσβασή του αμέσως.