API tokenek | Procurize.AI#

Generáljon, kezeljen és használjon API tokeneket a biztonságos programozott hozzáféréshez a Procurize.AI munkaterületén.

Alkalmazandó: Procurize.AI irányítópult → Beállítások → Tokenek
Elérhető: Business & Enterprise csomagokban
Szükséges szerepkör: Admin vagy Maintainer

Áttekintés#

Az API tokenek biztosítják a biztonságos, programozott hozzáférést a Procurize.AI platformhoz. A tokenekkel integrálhatja a Procurize.AI-t belső rendszereivel, automatizálhatja a munkafolyamatokat, vagy egyedi alkalmazásokat építhet a platformra.

Fő jellemzők:

A tokenek öröklik az összes jogosultságot annak a felhasználónak, aki létrehozta őket
A tokenek szervezeti körűek – nincs szükség az org megadására az API hívásokban
Korlátlan számú token generálható
A tokeneknek lehet lejárati dátuma, vagy beállítható a soha lejáratlan állapot
A tokenek deaktiválhatók, majd később újra aktiválhatók szükség szerint

🔒 Biztonsági megjegyzés: A Procurize.AI nem tárolja a token értékét – csak a hash-ét. A token értékét azonnal másolnia és el kell mentenie a generálás után. Nem lesz újra megjelenítve.

A tokenkezelő panel elérése#

Navigáljon a Dashboard → Settings → Tokens fülre.
A tokenkezelő panel megjeleníti a személyes tokenjeit, amelyek az aktuális szervezethez tartoznak.

API tokenek panel

Szükséges jogosultság: Csak Admin vagy Maintainer szerepkörrel rendelkező felhasználók érhetik el ezt a panelt. A részletes szerepkörökért lásd a Permissions Overview oldalt.

Új token generálása#

Adjon meg egy Név-et a token céljának azonosításához.
Válasszon egy lejárati időszak-ot:
- 1 hónap
- 3 hónap
- 1 év
- Nincs lejárat (korlátlan érvényesség)
Kattintson a „Generálás” gombra.

Fontos – Másolja a token értékét azonnal#

A generálás után a token értéke egyszer jelenik meg – másolja és tárolja biztonságosan (pl. jelszókezelőben vagy környezeti változóban).

Új API token

⚠️ Nem lesz lehetősége újra megtekinteni a token értékét. A Procurize.AI csak egy biztonságos hash-et tárol a hitelesítéshez. Ha elveszíti a tokenet, azonnal vonja vissza, és generáljon újat.

Létező tokenek kezelése#

A Tokenek panel megjeleníti az összes generált token listáját a következőkkel:

Név
Utótag
Létrehozás dátuma
Lejárati dátum (vagy “-”)
Állapot: Aktív vagy Inaktív

Deaktiválás / Újraaktiválás#

Deaktiválás – ideiglenesen letiltja a tokenet. Később, szükség esetén újra aktiválható.
Újraaktiválás – egy korábban deaktivált token visszaállítása aktív állapotba.

💡 A deaktiválás hasznos az integrációk ideiglenes felfüggesztésére token törlése nélkül.

Token visszavonása#

Visszavonás – véglegesen törli a tokenet. Ez a művelet nem visszavonható.
Ha elveszít egy tokenet, azonnal vonja vissza, és generáljon újat.

API token használata#

Alap URL & Hitelesítés#

Paraméter	Érték
Alap URL	`https://api.procurize.com`
Hitelesítési módszer	API kulcs a fejlécben
Fejléc	`X-API-Key: <YOUR_API_TOKEN>`

Példa kérés (cURL)#

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

🧠 Nincs szükség szervezet ID-re – a token a szervezethez kötődik, így az API automatikusan megoldja a kontextust.

Fontos biztonsági és használati szabályok#

Szabály	Magyarázat
Token jogosultságok	A token pontosan ugyanolyan jogosultságokkal rendelkezik, mint a létrehozó felhasználó. Ha a felhasználó szerepköre megváltozik, a token jogosultságai is frissülnek.
Szervezet kötés	A tokenek a létrehozó szervezetéhez vannak kötve. Nem lehet egy tokenet több szervezetben használni.
Token láthatóság	A token értéke csak egyszer jelenik meg. Tárolja azonnal. A Procurize.AI csak egy hash-et tárol.
Lejárt tokenek	A lejárt tokenek automatikusan deaktiválásra kerülnek és nem használhatók. Szükség esetén generáljon újat.

Hibaelhárítás#

Probléma	Megoldás
“Érvénytelen API kulcs” hiba	Ellenőrizze, hogy a token helyesen van-e másolva (nincs extra szóköz). Győződjön meg róla, hogy a token még aktív és nem járt le.
Token nem működik szerepkörváltozás után	A token jogosultságai frissülnek a felhasználó jelenlegi szerepkörével. Ha a felhasználó jogosultságai megváltoztak, a token is elveszíti azokat.
Elveszett token	Vonja vissza az elveszett tokenet, és generáljon újat.
Sebességkorlátozás	Az API sebességkorlátozások a csomagtól függnek. Ellenőrizze a `X-RateLimit-*` fejlécet a válaszban.

Kapcsolódó témák#

Permissions Overview – részletes szerepkördefiníciók
Pricing Plans – mely csomagok tartalmaznak API hozzáférést
REST API Reference – részletes végpont dokumentáció