Tokenuri API | Procurize.AI#

Generează, gestionează și folosește tokenuri API pentru acces programatic securizat la spațiul tău de lucru Procurize.AI.

Se aplică la: Procurize.AI Dashboard → Settings → Tokens
Disponibil în: planurile Business & Enterprise
Rol necesar: Security Manager, Editor, Admin sau Maintainer

Prezentare generală#

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

Caracteristici cheie:

• Tokenurile moștenesc toate permisiunile utilizatorului care le-a creat
• Tokenurile sunt legate de organizație – nu este nevoie să specifici 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 ulterior reactivate după necesitate

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

Accesarea panoului de gestionare a tokenurilor#

1. Navighează la pagina Dashboard → API Tokens.
2. Panoul de gestionare a tokenurilor afișează tokenurile tale personale asociate cu organizația curentă.

Permisiune necesară: Doar utilizatorii cu rolurile Security Manager, Editor, Admin sau Maintainer pot accesa acest panou. Pentru definiții detaliate ale rolurilor, vezi Prezentare generală a permisiunilor .

Generarea unui token nou#

1. Introdu un Nume pentru a identifica scopul tokenului.

2. Selectează o perioadă de expirare:

   • 1 lună
   • 3 luni
   • 1 an
   • Fără expirare (valabilitate nelimitată)

3. Apasă „Generate”.

Important – Copiază tokenul imediat#

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

⚠️ Nu vei mai putea vizualiza valoarea tokenului. Procurize.AI stochează doar un hash securizat pentru verificare. Dacă pierzi tokenul, trebuie să îl revoci și să generezi unul nou.

Gestionarea tokenurilor existente#

Panoul Tokenuri afișează o listă cu toate tokenurile generate, incluzând:

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

Dezactivarea / Reactivarea unui token#

• Dezactivează – dezactivează temporar tokenul. Poți să îl reactivezi ulterior când este nevoie.
• Reactivează – readuce un token dezactivat anterior în 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ă pierzi un token, revocă‑l imediat și generează unul nou.

Folosirea unui token API#

URL de bază & Autentificare#

Exemplu de cerere (cURL)#

curl -X GET "https://api.procurize.com/v1/documents" \
  -H "X-API-Key: TOKENUL_TĂU_API"

🧠 Nu este necesar ID‑ul organizației – tokenul este legat de organizația ta, astfel API‑ul rezolvă contextul automat.

Reguli importante de securitate și utilizare#

Depanare#

Subiecte conexe#

• Prezentare generală a permisiunilor – definiții detaliate ale rolurilor
• Planuri tarifare – care planuri includ acces API
• Referință REST API – documentație detaliată a endpoint‑urilor