# Tokenuri API | Procurize.AI

**Generați, gestionați și utilizați tokenuri API pentru acces programatic sigur la spațiul de lucru Procurize.AI.**

> **Se aplică la:** Procurize.AI Dashboard → Settings → Tokens  
> **Disponibil în:** planurile Business & Enterprise  
> **Rol necesar:** Administrator sau Maintainer

## Prezentare generală

Tokenurile API permit acces securizat și programatic la platforma Procurize.AI. Le puteți folosi pentru a integra Procurize.AI cu sistemele interne, a automatiza fluxuri de lucru sau a construi aplicații personalizate pe platformă.

**Caracteristici cheie:**

- Tokenurile moștenesc **toate permisiunile** utilizatorului care le-a creat
- Tokenurile sunt **încadrate la nivel de organizație** – nu este nevoie să se specifice `org` în apelurile API
- Se pot genera tokenuri nelimitate
- Tokenurile pot avea **date de expirare** sau pot fi setate să nu expire niciodată
- Tokenurile pot fi **dezactivate** și apoi **reactivate** după necesitate

> 🔒 **Notă de securitate:** Procurize.AI nu stochează valoarea tokenului – doar hash‑ul său. Trebuie să copiați și să salvați tokenul imediat după generare. Nu va mai fi afișat din nou.

## Accesarea Panoului de Management al Tokenurilor

1. Navigați la fila **Dashboard** → **Settings** → **Tokens**.
2. Panoul de management al tokenurilor afișează tokenurile personale asociate cu organizația curentă.

![Panoul de tokenuri API](/images/docs/api-tokens-panel.png)

> **Permisiune necesară:** Doar utilizatorii cu rolurile **Admin** sau **Maintainer** pot accesa acest panou. Pentru definiții detaliate ale rolurilor, vedeți [Prezentarea Permisiunilor](/what-user-permissions-does-procurize-have/) .

## Generarea unui Token Nou

1. Introduceți un **Nume** pentru a identifica scopul tokenului.
2. Selectați o **perioadă de expirare**:
   - 1 lună
   - 3 luni
   - 1 an
   - **Fără expirare** (valabilitate nelimitată)

3. Apăsați **"Generează"**.

### Important – Copiați Tokenul Imediat

După generare, valoarea tokenului este **afișată o singură dată** – copiați‑o și stocați‑o în siguranță (de ex. într-un manager de parole sau variabilă de mediu).

![Token API nou](/images/docs/new-api-token.png)

> ⚠️ **Nu veți mai putea vizualiza valoarea tokenului din nou.** Procurize.AI stochează doar un hash securizat pentru verificare. Dacă pierdeți tokenul, trebuie să îl revocați și să generați unul nou.

## Gestionarea Tokenurilor Existente

Panoul Tokenuri afișează o listă cu toate tokenurile generate și următoarele informații:

- Nume
- Sufix
- Data creării
- Data expirării (sau „-”)
- Stare: **Activ** sau **Inactiv**

### Dezactivarea / Reactivarea unui Token

- **Dezactivează** – dezactivează temporar tokenul. Îl puteți reactiva mai târziu când este necesar.
- **Reactivează** – restabilește un token dezactivat anterior la stare activă.

> 💡 Dezactivarea este utilă pentru suspendarea temporară a integrărilor fără a șterge tokenul.

### Revocarea unui Token

- **Revocă** – șterge permanent tokenul. Această acțiune nu poate fi anulată.
- Dacă pierdeți un token, revocați‑l imediat și generați unul nou.

## Utilizarea unui Token API

### URL de bază & Autentificare

| Parametru | Valoare |
|-----------|---------|
| **Base URL** | `https://api.procurize.com` |
| **Metodă de autentificare** | API key via header |
| **Header** | `X-API-Key: <YOUR_API_TOKEN>` |

### Exemplu de Cerere (cURL)

```bash
curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: YOUR_API_TOKEN"
```

> 🧠 **Nu este necesar ID-ul organizației** – tokenul este legat de organizația dumneavoastră, astfel API-ul rezolvă contextul automat.

## Reguli Importante de Securitate și Utilizare

| Regulă | Explicație |
|--------|------------|
| **Permisiunile tokenului** | Tokenul are exact aceleași permisiuni ca utilizatorul care l‑a creat. Dacă rolul utilizatorului se schimbă, permisiunile tokenului se actualizează în consecință. |
| **Legarea la organizație** | Tokenurile sunt legate de organizația creatorului. Nu puteți folosi un token în mai multe organizații. |
| **Vizibilitatea tokenului** | Valoarea tokenului este afișată **o singură dată**. Salvați‑o imediat. Procurize.AI stochează doar un hash. |
| **Tokenuri expirate** | Tokenurile expirate sunt dezactivate automat și nu pot fi utilizate. Generați un token nou dacă este necesar. |

## Depanare

| Problemă | Soluție |
|----------|---------|
| **Eroarea „Cheie API invalidă”** | Verificați că tokenul este copiat corect (fără spații suplimentare). Asigurați‑vă că tokenul este încă activ și nu a expirat. |
| **Tokenul nu funcționează după schimbarea rolului** | Permisiunile tokenului sunt actualizate pentru a se potrivi cu rolul curent al utilizatorului. Dacă utilizatorul a pierdut permisiuni, tokenul și el le pierde. |
| **Token pierdut** | Revocați tokenul pierdut și generați unul nou. |
| **Limitarea ratei** | Se aplică limitări de rată API în funcție de planul dumneavoastră. Verificați antetele `X-RateLimit-*` din răspuns. |

## Subiecte Conexe

- [Prezentarea Permisiunilor](/what-user-permissions-does-procurize-have/) – definiții detaliate ale rolurilor
- [Planuri de Preț](https://www.procurize.ai/pricing/) – ce planuri includ acces API
- [Referință REST API](/rest-api-reference/) – documentație detaliată a endpoint‑urilor

{{<article-feedback>}}