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ă.

Permisiune necesară: Doar utilizatorii cu rolurile Admin sau Maintainer pot accesa acest panou. Pentru definiții detaliate ale rolurilor, vedeți Prezentarea Permisiunilor .

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).

⚠️ 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#

Exemplu de Cerere (cURL)#

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#

Depanare#

Subiecte Conexe#

• Prezentarea Permisiunilor – definiții detaliate ale rolurilor
• Planuri de Preț – ce planuri includ acces API
• Referință REST API – documentație detaliată a endpoint‑urilor