# 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

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

![API tokeni panel](/images/docs/api-tokens-panel.png)

> **Potrebna dozvola:** Samo korisnici s **Admin** ili **Maintainer** ulogama mogu pristupiti ovom panelu. Za detaljne definicije uloga, pogledajte [Pregled dozvola](/what-user-permissions-does-procurize-have/) .

## Generiranje novog tokena

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

3. 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](/images/docs/new-api-token.png)

> ⚠️ **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)

```bash
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](/what-user-permissions-does-procurize-have/) – detaljne definicije uloga
- [Planovi cijena](https://www.procurize.ai/pricing/) – koji planovi uključuju API pristup
- [REST API referenca](/rest-api-reference/) – detaljna dokumentacija endpointa

{{<article-feedback>}}