API tokeny | Procurize.AI#

Generujte, spravujte a používejte API tokeny pro bezpečný programový přístup k vašemu pracovním prostoru Procurize.AI.

Platí pro: Dashboard Procurize.AI → Nastavení → Tokeny
K dispozici v: plánech Business a Enterprise
Požadovaná role: Security Manager, Editor, Admin nebo Maintainer

Přehled#

API tokeny umožňují bezpečný, programový přístup k platformě Procurize.AI. Tokeny můžete použít k integraci Procurize.AI s vašimi interními systémy, automatizaci pracovních postupů nebo tvorbě vlastních aplikací na platformě.

Klíčové vlastnosti:

Tokeny dědí všechna oprávnění uživatele, který je vytvořil
Tokeny jsou na úrovni organizace – není nutné uvádět org v API voláních
Lze vygenerovat neomezený počet tokenů
Tokeny mohou mít datum expirace nebo být nastaveny jako nevyprší
Tokeny mohou být deaktivovány a později znovu aktivovány podle potřeby

🔒 Bezpečnostní poznámka: Procurize.AI neukládá hodnotu tokenu – pouze jeho hash. Musíte token okamžitě po vygenerování zkopírovat a uložit. Nebude znovu zobrazen.

Přístup k panelu správy tokenů#

Přejděte na stránku Dashboard → API tokeny.
Panel správy tokenů zobrazuje vaše osobní tokeny spojené s aktuální organizací.

Stránka API tokenů

Požadované oprávnění: Pouze uživatelé s rolemi Security Manager, Editor, Admin nebo Maintainer mohou tento panel otevřít. Pro podrobné definice rolí viz Přehled oprávnění .

Generování nového tokenu#

Zadejte Název pro identifikaci účelu tokenu.
Vyberte období expirace:
- 1 měsíc
- 3 měsíce
- 1 rok
- Bez expirace (neomezená platnost)
Klikněte na „Generovat“.

Důležité – Okamžitě zkopírujte token#

Po vygenerování je hodnota tokenu zobrazena jednou – zkopírujte ji a uložte bezpečně (např. do správce hesel nebo jako proměnnou prostředí).

Nový API token

⚠️ Nebudete moci hodnotu tokenu znovu zobrazit. Procurize.AI ukládá pouze bezpečný hash pro ověření. Pokud token ztratíte, musíte jej odvolat a vygenerovat nový.

Správa existujících tokenů#

Panel tokenů zobrazuje seznam všech vygenerovaných tokenů s jejich:

Název
Přípona
Datum vytvoření
Datum expirace (nebo „-“)
Stav: Aktivní nebo Neaktivní

Deaktivace / Reactivace tokenu#

Deaktivovat – dočasně zakáže token. Můžete jej později znovu aktivovat, pokud bude potřeba.
Reaktivovat – obnoví dříve deaktivovaný token do aktivního stavu.

💡 Deaktivace je užitečná pro dočasné pozastavení integrací bez mazání tokenu.

Odvolání tokenu#

Odvolat – trvale smaže token. Tuto akci nelze vrátit.
Pokud token ztratíte, okamžitě jej odvolejte a vygenerujte nový.

Použití API tokenu#

Základní URL a autentizace#

Parametr	Hodnota
Základní URL	`https://api.procurize.com`
Metoda autentizace	API klíč v hlavičce
Hlavička	`X-API-Key: <YOUR_API_TOKEN>`

Příklad požadavku (cURL)#

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

🧠 Není potřeba ID organizace – token je svázán s vaší organizací, takže API automaticky určí kontext.

Důležité bezpečnostní a používací pravidla#

Pravidlo	Vysvětlení
Oprávnění tokenu	Token má přesně stejná oprávnění jako uživatel, který jej vytvořil. Pokud se role uživatele změní, oprávnění tokenu se aktualizují.
Vazba na organizaci	Tokeny jsou svázány s organizací tvůrce. Nemůžete token použít napříč více organizacemi.
Viditelnost tokenu	Hodnota tokenu je zobrazena pouze jednou. Okamžitě ji uložte. Procurize.AI ukládá pouze hash.
Expirované tokeny	Expirované tokeny jsou automaticky deaktivovány a nelze je použít. V případě potřeby vygenerujte nový token.

Řešení problémů#

Problém	Řešení
Chyba „Invalid API key“	Zkontrolujte, že je token správně zkopírován (žádné nadbytečné mezery). Ověřte, že je token stále aktivní a nevypršel.
Token nefunguje po změně role	Oprávnění tokenu jsou aktualizována tak, aby odpovídala aktuální roli uživatele. Pokud uživatel přišel o oprávnění, token je také ztratí.
Ztracený token	Odvolejte ztracený token a vygenerujte nový.
Omezení rychlosti	Limity rychlosti API se aplikují podle vašeho plánu. Zkontrolujte hlavičky `X-RateLimit-*` v odpovědi.

Související témata#

Přehled oprávnění – podrobné definice rolí
Cenové plány – které plány zahrnují přístup k API
Reference REST API – podrobná dokumentace endpointů