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#

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

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

Vytvorenie nového tokenu#

Zadajte Názov, ktorý identifikuje účel tokenu.
Vyberte obdobie expirácie:
- 1 mesiac
- 3 mesiace
- 1 rok
- Bez expirácie (neobmedzená platnosť)
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

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

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í – podrobné definície rolí
Cenové plány – ktoré plány obsahujú prístup k API
REST API Referencia – podrobná dokumentácia koncových bodov