API tokeny | Procurize.AI#

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

Platí pre: Procurize.AI Dashboard → Settings → Tokens
Dostupné v plánoch: Business a Enterprise
Požadovaná rola: Security Manager, Editor, Admin alebo Maintainer

Prehľad#

API tokeny umožňujú bezpečný, programový prístup k platforme 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 vytváranie vlastných aplikácií na platforme.

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 požiadavkách
Môže sa vygenerovať neobmedzený počet tokenov
Tokeny môžu mať dátumy expirácie alebo môžu byť nastavené na nevypršanie
Tokeny môžu byť deaktivované a neskôr reaktivované podľa potreby

🔒 Bezpečnostná poznámka: Procurize.AI neukladá hodnotu tokenu – iba jeho hash. Musíte token okamžite po vygenerovaní skopírovať a uložiť. Už sa nezobrazí.

Prístup k panelu správy tokenov#

Prejdite na stránku Dashboard → API Tokens.
Panel správy tokenov zobrazuje vaše osobné tokeny priradené k aktuálnej organizácii.

Stránka s tokenmi API

Požadované oprávnenie: Iba používatelia s rolami Security Manager, Editor, Admin alebo Maintainer môžu tento panel otvoriť. Pre podrobné definície rolí pozrite Prehľad oprávnení .

Generovanie 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 na „Generate“.

Dôležité – Skopírujte token okamžite#

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

Nový API token

⚠️ Hodnota tokenu už nebude možné zobraziť. Procurize.AI ukladá iba 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 / Reaktivácia tokenu#

Deaktivovať – dočasne zakáže token. Neskôr ho môžete reaktivovať podľa potreby.
Reaktivovať – obnoví predtým deaktivovaný token do aktívneho stavu.

💡 Deaktivácia je užitočná na dočasné pozastavenie 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 vygenerujte nový.

Používanie API tokenu#

Základná URL a autentifikácia#

Parameter	Hodnota
Base URL	`https://api.procurize.com`
Metóda autentifikácie	API kľúč cez hlavičku
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é ID organizácie – token je viazaný na vašu organizáciu, takže API automaticky určí kontext.

Dôležité pravidlá bezpečnosti a používania#

Pravidlo	Vysvetlenie
Oprávnenia tokenu	Token má presne rovnaké oprávnenia ako používateľ, ktorý ho vytvoril. Ak sa rola používateľa zmení, oprávnenia tokenu sa aktualizujú automaticky.
Viazanosť 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 okamžite. Procurize.AI ukladá iba hash.
Expirujúce tokeny	Expirujúce tokeny sa automaticky deaktivujú a nie je ich možné použiť. V prípade potreby vygenerujte nový token.

Riešenie problémov#

Problém	Riešenie
Chyba „Invalid API key“	Skontrolujte, či je token správne skopírovaný (bez nadbytočných medzier). Overte, že token je stále aktívny a nevypršal.
Token nefunguje po zmene roly	Oprávnenia tokenu sa aktualizujú podľa aktuálnej roly používateľa. Ak používateľ stratí 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 zahŕňajú prístup k API
Referenčný manuál REST API – podrobná dokumentácia koncových bodov