# API tokeny | Procurize.AI

**Generujte, spravujte a používajte API tokeny pre bezpečný programový prístup k vášmu pracovisku v Procurize.AI.**

> **Platí pre:** Procurize.AI Dashboard → Nastavenia → Tokeny  
> **Dostupné v:** Plánoch Business a Enterprise  
> **Požadovaná rola:** Administrátor alebo Údržbár

## Prehľad

API tokeny umožňujú bezpečný programový prístup na platformu Procurize.AI. Môžete ich použiť na integráciu Procurize.AI s vašimi internými systémami, automatizáciu pracovných postupov alebo tvorbu vlastných aplikácií nad platformou.

**Kľúčové charakteristiky:**

- Tokeny zdedia **všetky oprávnenia** používateľa, ktorý ich vytvoril
- Tokeny sú **viazané na organizáciu** – nie je potrebné špecifikovať `org` v API volaniach
- Počet tokenov je neobmedzený
- Tokeny môžu mať **dátumy expirácie** alebo nastavené tak, aby nikdy neexpirovali
- Tokeny môžu byť **deaktivované** a neskôr **znovu aktivované** podľa potreby

> 🔒 **Bezpečnostná poznámka:** Procurize.AI **neukladá** samotnú hodnotu tokenu – len jeho hash. Token je potrebné skopírovať a uložiť hneď po vygenerovaní. Už sa nebude zobrazovať.

## Prístup k panelu Správy tokenov

1. Prejdite na **Dashboard** → **Nastavenia** → kartu **Tokeny**.  
2. Panel správy tokenov zobrazuje vaše osobné tokeny pridelené k aktuálnej organizácii.

![Panel API tokenov](/images/docs/api-tokens-panel.png "Panel API tokenov")

> **Vyžadované oprávnenie:** Iba používatelia s rolou **Administrátor** alebo **Údržbár** môžu tento panel otvoriť. Pre podrobné definície rolí pozrite [Prehľad oprávnení](/what-user-permissions-does-procurize-have/) .

## Vytvorenie nového tokenu

1. Zadajte **Názov**, ktorý identifikuje účel tokenu.  
2. Vyberte **obdobie expirácie**:
   - 1 mesiac
   - 3 mesiace
   - 1 rok
   - **Bez expirácie** (neobmedzená platnosť)

3. Kliknite **„Generovať“**.

### Dôležité – Skopírujte token hneď

Po vygenerovaní sa hodnota tokenu **zobrazí len raz** – skopírujte ju a uložte bezpečne (napr. v správcovi hesiel alebo ako premennú prostredia).

![Nový API token](/images/docs/new-api-token.png "Nový API token")

> ⚠️ **Token už nebudete môcť znova zobraziť.** Procurize.AI ukladá len bezpečný hash pre overenie. Ak token stratíte, musíte ho odvolať a vygenerovať nový.

## Správa existujúcich tokenov

Panel Tokeny zobrazuje zoznam všetkých vygenerovaných tokenov s ich:

- Názvom
- Príponou
- Dátumom vytvorenia
- Dátumom expirácie (alebo „-“)
- Stavom: **Aktívny** alebo **Neaktívny**

### Deaktivácia / Reactivácia tokenu

- **Deaktivovať** – dočasne deaktivuje token. Neskôr ho môžete znovu aktivovať.  
- **Reaktivovať** – obnoví predtým deaktivovaný token do aktívneho stavu.

> 💡 Deaktivácia je užitočná pri dočasnom pozastavení integrácií bez mazania tokenu.

### Odvolanie tokenu

- **Odvolať** – trvalo odstráni token. Túto akciu nie je možné vrátiť späť.  
- Ak token stratíte, okamžite ho odvolajte a vytvorte nový.

## Používanie API tokenu

### Základná URL a autentifikácia

| Parameter               | Hodnota                         |
|-------------------------|---------------------------------|
| **Základná URL**        | `https://api.procurize.com`     |
| **Metóda autentifikácie** | API kľúč v hlavičke              |
| **Hlavička**            | `X-API-Key: <YOUR_API_TOKEN>`   |

### Príklad požiadavky (cURL)

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

> 🧠 **Nie je potrebné zadávať ID organizácie** – token je viazaný na vašu organizáciu, takže API automaticky určuje kontext.

## Dôležité pravidlá zabezpečenia a používania

| Pravidlo                | Vysvetlenie                                                                                              |
|------------------------|----------------------------------------------------------------------------------------------------------|
| **Oprávnenia tokenu**   | Token má úplne rovnaké oprávnenia ako používateľ, ktorý ho vytvoril. Ak sa rola používateľa zmení, aktualizujú sa aj oprávnenia tokenu. |
| **Väzba na organizáciu** | Tokeny sú viazané na organizáciu tvorcu. Nie je možné použiť token v rámci viacerých organizácií.          |
| **Viditeľnosť tokenu**  | Hodnota tokenu sa zobrazí **iba raz**. Uložte ju hneď. Procurize.AI ukladá len hash.                        |
| **Expirácia tokenov**   | Expirujúce tokeny sa automaticky deaktivujú a nie je ich možné použiť. V prípade potreby vygenerujte nový. |

## Riešenie problémov

| Problém                                 | Riešenie                                                                                       |
|-----------------------------------------|------------------------------------------------------------------------------------------------|
| **Chyba „Invalid API key“**             | Overte, že ste token skopírovali správne (bez nadbytočných medzier). Skontrolujte, či je token stále aktívny a neexpiroval. |
| **Token nefunguje po zmene roly**       | Oprávnenia tokenu sa aktualizujú podľa aktuálnej roly používateľa. Ak používateľ prišiel o oprávnenia, token ich tiež stratí. |
| **Stratený token**                      | Odvolajte stratený token a vygenerujte nový.                                                   |
| **Obmedzenie rýchlosti (rate limiting)** | Limity rýchlosti API sa uplatňujú podľa vášho plánu. Skontrolujte hlavičky `X-RateLimit-*` v odpovedi. |

## Súvisiace témy

- [Prehľad oprávnení](/what-user-permissions-does-procurize-have/) – podrobné definície rolí  
- [Cenové plány](https://www.procurize.ai/pricing/) – ktoré plány obsahujú prístup k API  
- [REST API Referencia](/rest-api-reference/) – podrobná dokumentácia koncových bodov  

{{<article-feedback>}}