API tokeni | Procurize.AI#

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

Primjenjuje se na: Procurize.AI nadzorna ploča → Postavke → Tokeni
Dostupno u: Business i Enterprise planovima
Potrebna uloga: Security Manager, Editor, 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 izraditi prilagođene aplikacije na vrhu platforme.

Ključne karakteristike:

Tokeni nasljeđuju sve dozvole korisnika koji ih je stvorio
Tokeni su ograničeni na organizaciju – nije potrebno navoditi org u API pozivima
Može se generirati neograničen broj tokena
Tokeni mogu imati datume isteka ili biti postavljeni da nikada ne isteknu
Tokeni se mogu deaktivirati i kasnije ponovno aktivirati po potrebi

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

Pristup panelu za upravljanje tokenima#

Idite na stranicu Dashboard → API Tokens.
Panel za upravljanje tokenima prikazuje vaše osobne tokene povezane s trenutnom organizacijom.

Stranica API tokena

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

Generiranje novog tokena#

Unesite Naziv kako biste identificirali svrhu tokena.
Odaberite razdoblje isteka:
- 1 mjesec
- 3 mjeseca
- 1 godina
- Bez isteka (neograničena valjanost)
Kliknite “Generiraj”.

Važno – Kopirajte token odmah#

Nakon generiranja, vrijednost tokena se prikazuje 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 provjeru. Ako izgubite token, morate ga opozvati i generirati novi.

Upravljanje postojećim tokenima#

Panel Tokeni prikazuje popis svih generiranih tokena s njihovim:

Nazivom
Sufiksom
Datumom stvaranja
Datumom isteka (ili “-”)
Statusom: Aktivan ili Neaktivan

Deaktiviranje / Reactiviranje tokena#

Deaktiviraj – privremeno onemogućuje token. Kasnije ga možete reaktivirati po potrebi.
Reaktiviraj – vraća prethodno deaktivirani token u aktivni status.

💡 Deaktivacija je korisna za privremeno suspendiranje integracija bez brisanja tokena.

Opozivanje tokena#

Opozovi – trajno briše token. Ova radnja se ne može poništiti.
Ako izgubite token, odmah ga opozovite i generirajte novi.

Korištenje API tokena#

Osnovni URL i autentifikacija#

Parametar	Vrijednost
Osnovni URL	`https://api.procurize.com`
Metoda autentifikacije	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 automatski ažuriraju.
Vezivanje uz organizaciju	Tokeni su vezani uz organizaciju tvorca. Token ne možete koristiti u više organizacija.
Vidljivost tokena	Vrijednost tokena se prikazuje samo jednom. Pohranite je odmah. Procurize.AI pohranjuje samo hash.
Istekli tokeni	Istekli tokeni se automatski deaktiviraju i ne mogu se koristiti. Generirajte novi token po potrebi.

Rješavanje problema#

Problem	Rješenje
Pogreška „Nevažeći API ključ“	Provjerite je li token ispravno kopiran (bez dodatnih razmaka). Provjerite je li token još aktivan i nije li istekao.
Token ne radi nakon promjene uloge	Dozvole tokena se ažuriraju prema trenutnoj ulozi korisnika. Ako je korisniku oduzeta dozvola, token također gubi tu dozvolu.
Izgubljeni token	Opozovite izgubljeni token i generirajte novi.
Ograničenje brzine	Ograničenja brzine API-ja ovise o vašem planu. Provjerite `X-RateLimit-*` zaglavlja u odgovoru.

Povezane teme#

Pregled dozvola – detaljne definicije uloga
Cjenovni planovi – koji planovi uključuju API pristup
REST API referenca – detaljna dokumentacija krajnjih točaka