Διακριτικά API | Procurize.AI#

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

Ισχύει για: Πίνακας Ελέγχου Procurize.AI → Ρυθμίσεις → Διακριτικά
Διαθέσιμο σε: Πακέτα Business & Enterprise
Απαιτούμενος ρόλος: Διαχειριστής Ασφαλείας, Επεξεργαστής, Διαχειριστής ή Συντηρητής

Επισκόπηση#

Τα διακριτικά API επιτρέπουν ασφαλή, προγραμματιστική πρόσβαση στην πλατφόρμα Procurize.AI. Μπορείτε να τα χρησιμοποιήσετε για να ενσωματώσετε το Procurize.AI με τα εσωτερικά σας συστήματα, να αυτοματοποιήσετε ροές εργασίας ή να δημιουργήσετε προσαρμοσμένες εφαρμογές πάνω στην πλατφόρμα.

Κύρια χαρακτηριστικά:

  • Τα διακριτικά κληρονομούν όλα τα δικαιώματα του χρήστη που τα δημιούργησε
  • Τα διακριτικά είναι σε επίπεδο οργάνωσης – δεν χρειάζεται να καθορίσετε org στις κλήσεις API
  • Μπορείτε να δημιουργήσετε απεριόριστο αριθμό διακριτικών
  • Τα διακριτικά μπορούν να έχουν ημερομηνίες λήξης ή να οριστούν ως απέραντα
  • Τα διακριτικά μπορούν να απενεργοποιηθούν και αργότερα επανενεργοποιηθούν ανάλογα με τις ανάγκες

🔒 Σημείωση ασφαλείας: Το Procurize.AI δεν αποθηκεύει την τιμή του διακριτικού – μόνο το hash του. Πρέπει να αντιγράψετε και να αποθηκεύσετε το διακριτικό αμέσως μετά τη δημιουργία. Δεν θα εμφανιστεί ξανά.

Πρόσβαση στον Πίνακα Διαχείρισης Διακριτικών#

  1. Μεταβείτε στη σελίδα Πίνακας ΕλέγχουΔιακριτικά API.
  2. Ο πίνακας διαχείρισης διακριτικών εμφανίζει τα προσωπικά σας διακριτικά που σχετίζονται με την τρέχουσα οργάνωση.

Σελίδα διακριτικών API

Απαιτούμενα δικαιώματα: Μόνο χρήστες με ρόλους Διαχειριστής Ασφαλείας, Επεξεργαστής, Διαχειριστής ή Συντηρητής μπορούν να έχουν πρόσβαση σε αυτόν τον πίνακα. Για λεπτομερείς ορισμούς ρόλων, δείτε το Επισκόπηση Δικαιωμάτων .

Δημιουργία Νέου Διακριτικού#

  1. Εισάγετε ένα Όνομα για να προσδιορίσετε τον σκοπό του διακριτικού.

  2. Επιλέξτε μια περίοδο λήξης:

    • 1 μήνας
    • 3 μήνες
    • 1 έτος
    • Χωρίς λήξη (απέραντη ισχύ)
  3. Κάντε κλικ στο «Δημιουργία».

Σημαντικό – Αντιγράψτε το Διακριτικό Αμέσως#

Μετά τη δημιουργία, η τιμή του διακριτικού εμφανίζεται μία φορά – αντιγράψτε την και αποθηκεύστε την με ασφάλεια (π.χ. σε διαχειριστή κωδικών ή μεταβλητή περιβάλλοντος).

Νέο διακριτικό API

⚠️ Δεν θα μπορείτε να δείτε ξανά την τιμή του διακριτικού. Το Procurize.AI αποθηκεύει μόνο ένα ασφαλές hash για επαλήθευση. Εάν χάσετε το διακριτικό, πρέπει να το ανακαλέσετε και να δημιουργήσετε ένα νέο.

Διαχείριση Υφιστάμενων Διακριτικών#

Ο πίνακας Διακριτικών εμφανίζει μια λίστα με όλα τα δημιουργημένα διακριτικά και τα εξής στοιχεία:

  • Όνομα
  • Κατάληξη
  • Ημερομηνία δημιουργίας
  • Ημερομηνία λήξης (ή “-”)
  • Κατάσταση: Ενεργό ή Ανενεργό

Απενεργοποίηση / Επανενεργοποίηση Διακριτικού#

  • Απενεργοποίηση – απενεργοποιεί προσωρινά το διακριτικό. Μπορείτε να το επανενεργοποιήσετε αργότερα όταν χρειαστεί.
  • Επανενεργοποίηση – επαναφέρει ένα προηγουμένως απενεργοποιημένο διακριτικό σε ενεργή κατάσταση.

💡 Η απενεργοποίηση είναι χρήσιμη για προσωρινή διακοπή ενσωματώσεων χωρίς διαγραφή του διακριτικού.

Ανάκληση Διακριτικού#

  • Ανάκληση – διαγράφει μόνιμα το διακριτικό. Αυτή η ενέργεια δεν μπορεί να αναιρεθεί.
  • Εάν χάσετε ένα διακριτικό, ανακαλέστε το αμέσως και δημιουργήστε ένα νέο.

Χρήση Διακριτικού API#

Βασική Διεύθυνση URL & Αυθεντικοποίηση#

ΠαράμετροςΤιμή
Base URLhttps://api.procurize.com
Authentication methodAPI key μέσω header
HeaderX-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-* στην απάντηση.

Σχετικά Θέματα#

στην κορυφή
Επιλογή γλώσσας