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

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

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

## Επισκόπηση

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

**Βασικά χαρακτηριστικά:**

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

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

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

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

![Πίνακας διακριτικών API](/images/docs/api-tokens-panel.png)

> **Απαιτούμενο δικαίωμα:** Μόνο οι χρήστες με ρόλους **Διαχειριστής** ή **Συντηρητής** μπορούν να έχουν πρόσβαση σε αυτόν τον πίνακα. Για λεπτομερείς ορισμούς ρόλων, δείτε το [Επισκόπηση Δικαιωμάτων](/what-user-permissions-does-procurize-have/) .

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

1. Εισάγετε ένα **Όνομα** για να προσδιορίσετε τον σκοπό του διακριτικού.  
2. Επιλέξτε μια **περίοδο λήξης**:
   - 1 μήνα
   - 3 μήνες
   - 1 έτος
   - **Χωρίς λήξη** (απεριόριστη ισχύ)

3. Κάντε κλικ στο **"Δημιουργία"**.

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

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

![Νέο διακριτικό API](/images/docs/new-api-token.png)

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

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

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

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

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

- **Απενεργοποίηση** – απενεργοποιεί προσωρινά το διακριτικό. Μπορείτε να το ενεργοποιήσετε ξανά όταν χρειαστεί.  
- **Επανενεργοποίηση** – επαναφέρει ένα προηγούμενο απενεργοποιημένο διακριτικό στην ενεργή κατάσταση.

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

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

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

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

### Βασικό URL & Έλεγχος Ταυτοποίησης

| Παράμετρος | Τιμή |
|-----------|-------|
| **Βασικό URL** | `https://api.procurize.com` |
| **Μέθοδος ελέγχου ταυτοποίησης** | Κλειδί API μέσω κεφαλίδας |
| **Κεφαλίδα** | `X-API-Key: <YOUR_API_TOKEN>` |

### Παράδειγμα Αιτήματος (cURL)

```bash
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 εφαρμόζονται βάσει του σχεδίου σας. Ελέγξτε τις κεφαλίδες `X-RateLimit-*` στην απάντηση. |

## Σχετικό Περιεχόμενο

- [Επισκόπηση Δικαιωμάτων](/what-user-permissions-does-procurize-have/) – λεπτομερείς ορισμοί ρόλων  
- [Σχέδια Τιμολόγησης](https://www.procurize.ai/pricing/) – ποια σχέδια περιλαμβάνουν πρόσβαση API  
- [Αναφορά REST API](/rest-api-reference/) – λεπτομερή τεκμηρίωση τελικών σημείων  

{{<article-feedback>}}