Διακριτικά API | Procurize.AI#
Δημιουργήστε, διαχειριστείτε και χρησιμοποιήστε διακριτικά API για ασφαλή προγραμματιστική πρόσβαση στον χώρο εργασίας σας στο Procurize.AI.
Ισχύει για: Πίνακας Ελέγχου Procurize.AI → Ρυθμίσεις → Διακριτικά
Διαθέσιμο σε: Πακέτα Business & Enterprise
Απαιτούμενος ρόλος: Διαχειριστής Ασφαλείας, Επεξεργαστής, Διαχειριστής ή Συντηρητής
Επισκόπηση#
Τα διακριτικά API επιτρέπουν ασφαλή, προγραμματιστική πρόσβαση στην πλατφόρμα Procurize.AI. Μπορείτε να τα χρησιμοποιήσετε για να ενσωματώσετε το Procurize.AI με τα εσωτερικά σας συστήματα, να αυτοματοποιήσετε ροές εργασίας ή να δημιουργήσετε προσαρμοσμένες εφαρμογές πάνω στην πλατφόρμα.
Κύρια χαρακτηριστικά:
- Τα διακριτικά κληρονομούν όλα τα δικαιώματα του χρήστη που τα δημιούργησε
- Τα διακριτικά είναι σε επίπεδο οργάνωσης – δεν χρειάζεται να καθορίσετε
orgστις κλήσεις API - Μπορείτε να δημιουργήσετε απεριόριστο αριθμό διακριτικών
- Τα διακριτικά μπορούν να έχουν ημερομηνίες λήξης ή να οριστούν ως απέραντα
- Τα διακριτικά μπορούν να απενεργοποιηθούν και αργότερα επανενεργοποιηθούν ανάλογα με τις ανάγκες
🔒 Σημείωση ασφαλείας: Το Procurize.AI δεν αποθηκεύει την τιμή του διακριτικού – μόνο το hash του. Πρέπει να αντιγράψετε και να αποθηκεύσετε το διακριτικό αμέσως μετά τη δημιουργία. Δεν θα εμφανιστεί ξανά.
Πρόσβαση στον Πίνακα Διαχείρισης Διακριτικών#
- Μεταβείτε στη σελίδα Πίνακας Ελέγχου → Διακριτικά API.
- Ο πίνακας διαχείρισης διακριτικών εμφανίζει τα προσωπικά σας διακριτικά που σχετίζονται με την τρέχουσα οργάνωση.

Απαιτούμενα δικαιώματα: Μόνο χρήστες με ρόλους Διαχειριστής Ασφαλείας, Επεξεργαστής, Διαχειριστής ή Συντηρητής μπορούν να έχουν πρόσβαση σε αυτόν τον πίνακα. Για λεπτομερείς ορισμούς ρόλων, δείτε το Επισκόπηση Δικαιωμάτων .
Δημιουργία Νέου Διακριτικού#
Εισάγετε ένα Όνομα για να προσδιορίσετε τον σκοπό του διακριτικού.
Επιλέξτε μια περίοδο λήξης:
- 1 μήνας
- 3 μήνες
- 1 έτος
- Χωρίς λήξη (απέραντη ισχύ)
Κάντε κλικ στο «Δημιουργία».
Σημαντικό – Αντιγράψτε το Διακριτικό Αμέσως#
Μετά τη δημιουργία, η τιμή του διακριτικού εμφανίζεται μία φορά – αντιγράψτε την και αποθηκεύστε την με ασφάλεια (π.χ. σε διαχειριστή κωδικών ή μεταβλητή περιβάλλοντος).

⚠️ Δεν θα μπορείτε να δείτε ξανά την τιμή του διακριτικού. Το Procurize.AI αποθηκεύει μόνο ένα ασφαλές hash για επαλήθευση. Εάν χάσετε το διακριτικό, πρέπει να το ανακαλέσετε και να δημιουργήσετε ένα νέο.
Διαχείριση Υφιστάμενων Διακριτικών#
Ο πίνακας Διακριτικών εμφανίζει μια λίστα με όλα τα δημιουργημένα διακριτικά και τα εξής στοιχεία:
- Όνομα
- Κατάληξη
- Ημερομηνία δημιουργίας
- Ημερομηνία λήξης (ή “-”)
- Κατάσταση: Ενεργό ή Ανενεργό
Απενεργοποίηση / Επανενεργοποίηση Διακριτικού#
- Απενεργοποίηση – απενεργοποιεί προσωρινά το διακριτικό. Μπορείτε να το επανενεργοποιήσετε αργότερα όταν χρειαστεί.
- Επανενεργοποίηση – επαναφέρει ένα προηγουμένως απενεργοποιημένο διακριτικό σε ενεργή κατάσταση.
💡 Η απενεργοποίηση είναι χρήσιμη για προσωρινή διακοπή ενσωματώσεων χωρίς διαγραφή του διακριτικού.
Ανάκληση Διακριτικού#
- Ανάκληση – διαγράφει μόνιμα το διακριτικό. Αυτή η ενέργεια δεν μπορεί να αναιρεθεί.
- Εάν χάσετε ένα διακριτικό, ανακαλέστε το αμέσως και δημιουργήστε ένα νέο.
Χρήση Διακριτικού API#
Βασική Διεύθυνση URL & Αυθεντικοποίηση#
| Παράμετρος | Τιμή |
|---|---|
| Base URL | https://api.procurize.com |
| Authentication method | API key μέσω header |
| Header | X-API-Key: <YOUR_API_TOKEN> |
Παράδειγμα Αιτήματος (cURL)#
curl -X GET "https://api.procurize.com/v1/documents" \
-H "X-API-Key: YOUR_API_TOKEN"
🧠 Δεν απαιτείται ID οργάνωσης – το διακριτικό είναι δεσμευμένο στην οργάνωσή σας, οπότε το API καθορίζει αυτόματα το πλαίσιο.
Σημαντικοί Κανόνες Ασφαλείας & Χρήσης#
| Κανόνας | Επεξήγηση |
|---|---|
| Δικαιώματα διακριτικού | Το διακριτικό έχει ακριβώς τα ίδια δικαιώματα με τον χρήστη που το δημιούργησε. Εάν αλλάξει ο ρόλος του χρήστη, τα δικαιώματα του διακριτικού ενημερώνονται αναλόγως. |
| Δέσμευση οργάνωσης | Τα διακριτικά είναι δεσμευμένα στην οργάνωση του δημιουργού. Δεν μπορείτε να χρησιμοποιήσετε ένα διακριτικό σε πολλαπλές οργανώσεις. |
| Ορατότητα διακριτικού | Η τιμή του διακριτικού εμφανίζεται μόνο μία φορά. Αποθηκεύστε την αμέσως. Το Procurize.AI αποθηκεύει μόνο ένα hash. |
| Ληγμένα διακριτικά | Τα ληγμένα διακριτικά απενεργοποιούνται αυτόματα και δεν μπορούν να χρησιμοποιηθούν. Δημιουργήστε νέο διακριτικό εάν χρειάζεται. |
Επίλυση Προβλημάτων#
| Πρόβλημα | Λύση |
|---|---|
| Σφάλμα “Invalid API key” | Ελέγξτε ότι το διακριτικό έχει αντιγραφεί σωστά (χωρίς επιπλέον κενά). Βεβαιωθείτε ότι το διακριτικό είναι ακόμα ενεργό και δεν έχει λήξει. |
| Το διακριτικό δεν λειτουργεί μετά από αλλαγή ρόλου | Τα δικαιώματα του διακριτικού ενημερώνονται ώστε να ταιριάζουν με τον τρέχοντα ρόλο του χρήστη. Εάν ο χρήστης έχασε δικαιώματα, το διακριτικό επίσης τα χάνει. |
| Χαμένο διακριτικό | Ανακαλέστε το χαμένο διακριτικό και δημιουργήστε ένα νέο. |
| Περιορισμός ταχύτητας (Rate limiting) | Οι περιορισμοί ταχύτητας API εφαρμόζονται ανάλογα με το πακέτο σας. Ελέγξτε τα headers X-RateLimit-* στην απάντηση. |
Σχετικά Θέματα#
- Επισκόπηση Δικαιωμάτων – λεπτομερείς ορισμοί ρόλων
- Τιμολογιακά Πακέτα – ποια πακέτα περιλαμβάνουν πρόσβαση API
- Αναφορά REST API – λεπτομερής τεκμηρίωση σημείων λήψης
