API tokeni | Procurize.AI#

Generirajte, upravljajte i koristite API tokeni za siguran programatski pristup vašem radnom prostoru Procurize.AI.

Primjenjuje se na: Procurize.AI nadzorna ploča → Postavke → Tokeni
Dostupno na: Poslovni i Enterprise planovi
Potrebna uloga: Admin ili Maintainer

Pregled#

API tokeni omogućuju siguran, programatski pristup platformi Procurize.AI. Tokenima možete integrirati Procurize.AI s vašim internim sustavima, automatizirati radne tokove ili izgraditi prilagođene aplikacije na vrhu platforme.

Ključne značajke:

Tokeni nasljeđuju sve dozvole korisnika koji ih je stvorio
Tokeni su ograničeni na organizaciju – nije potrebno navoditi org u API pozivima
Mogu se generirati neograničeni tokeni
Tokeni mogu imati datume isteka ili biti postavljeni da ne isteknu
Tokeni se mogu deaktivirati i kasnije reaktivirati po potrebi

🔒 Napomena o sigurnosti: Procurize.AI ne pohranjuje vrijednost tokena – samo njegov hash. Morate kopirati i spremiti token odmah nakon generiranja. Više se neće prikazati.

Pristup panelu za upravljanje tokenima#

Idite na Nadzornu ploču → Postavke → karticu Tokeni.
Panel za upravljanje tokenima prikazuje vaše osobne tokene povezane s trenutnom organizacijom.

API tokeni panel

Potrebna dozvola: Samo korisnici s Admin ili Maintainer ulogama mogu pristupiti ovom panelu. Za detaljne definicije uloga, pogledajte Pregled dozvola .

Generiranje novog tokena#

Unesite Naziv za identifikaciju svrhe tokena.
Odaberite period isteka:
- 1 mjesec
- 3 mjeseca
- 1 godina
- Bez isteka (neograničena valjanost)
Kliknite „Generiraj“.

Važno – Kopirajte token odmah#

Nakon generiranja, vrijednost tokena prikazana je jednom – kopirajte je i pohranite sigurno (npr. u upravitelju lozinki ili varijabli okruženja).

Novi API token

⚠️ Nećete moći ponovno vidjeti vrijednost tokena. Procurize.AI pohranjuje samo siguran hash za verificiranje. Ako izgubite token, morate ga opozvati i generirati novi.

Upravljanje postojećim tokenima#

Panel Tokeni prikazuje popis svih generiranih tokena s njihovim:

Naziv
Sufiks
Datum stvaranja
Datum isteka (ili „-“)
Status: Aktivan ili Neaktivan

Deaktiviranje / Reactiviranje tokena#

Deaktiviraj – privremeno onemogućuje token. Možete ga ponovno aktivirati kasnije po potrebi.
Reaktiviraj – vraća prethodno deaktivirani token u aktivni status.

💡 Deaktiviranje je korisno za privremeno obustavljanje integracija bez brisanja tokena.

Opozivanje tokena#

Opozovi – trajno briše token. Ova radnja je nepovratna.
Ako izgubite token, odmah ga opozovite i generirajte novi.

Korištenje API tokena#

Osnovni URL & Autentikacija#

Parametar	Vrijednost
Osnovni URL	`https://api.procurize.com`
Metoda autentikacije	API ključ putem zaglavlja
Zaglavlje	`X-API-Key: <YOUR_API_TOKEN>`

Primjer zahtjeva (cURL)#

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

🧠 Nije potreban ID organizacije – token je vezan uz vašu organizaciju, pa API automatski otkriva kontekst.

Važna pravila sigurnosti i korištenja#

Pravilo	Objašnjenje
Dozvole tokena	Token ima točno iste dozvole kao i korisnik koji ga je stvorio. Ako se uloga korisnika promijeni, dozvole tokena se ažuriraju u skladu s tim.
Vezivanje organizacije	Tokeni su vezani uz organizaciju tvorca. Ne možete koristiti token u više organizacija.
Vidljivost tokena	Vrijednost tokena prikazana je samo jednom. Pohranite je odmah. Procurize.AI pohranjuje samo hash.
Istekli tokeni	Istekli tokeni automatski se deaktiviraju i ne mogu se koristiti. Po potrebi generirajte novi token.

Rješavanje problema#

Problem	Rješenje
Pogreška „Nevažeći API ključ“	Provjerite je li token pravilno kopiran (bez dodatnih razmaka). Provjerite je li token još aktivan i nije li istekao.
Token ne radi nakon promjene uloge	Dozvole tokena ažurirane su kako bi odgovarale trenutnoj ulozi korisnika. Ako je korisnik izgubio dozvole, token ih također gubi.
Izgubljeni token	Opozovite izgubljeni token i generirajte novi.
Ograničenje brzine	Ograničenja brzine API-ja primjenjuju se prema vašem planu. Provjerite `X-RateLimit-*` zaglavlja u odgovoru.

Povezane teme#

Pregled dozvola – detaljne definicije uloga
Planovi cijena – koji planovi uključuju API pristup
REST API referenca – detaljna dokumentacija endpointa