API tokenek | Procurize.AI#

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

Alkalmazandó: Procurize.AI Irányítópult → Beállítások → Tokenek
Elérhető: Business és Enterprise csomagokban
Szükséges szerepkör: Biztonsági menedzser, Szerkesztő, Admin vagy Karbantartó

Áttekintés#

Az API tokenek biztonságos, programozott hozzáférést biztosítanak 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őbb jellemzők:

A tokenek öröklik a létrehozó felhasználó összes jogosultságát
A tokenek szervezet‑szintűek – nem szükséges org paramétert megadni az API hívásokban
Korlátlan számú token generálható
A tokeneknek lehet lejárati dátuma, vagy beállítható, hogy soha ne járjanak le
A tokenek deaktiválhatók, majd szükség esetén újraaktiválhatók

🔒 Biztonsági megjegyzés: A Procurize.AI nem tárolja a token értékét – csak a hash‑ét. A token generálása után azonnal másolnia és biztonságosan el kell tárolnia. A token később már nem lesz látható.

A tokenkezelő panel elérése#

Navigáljon a Dashboard → API tokenek oldalra.
A tokenkezelő panel megjeleníti az aktuális szervezethez tartozó személyes tokenjeit.

API tokenek oldal

Szükséges jogosultság: Csak a Biztonsági menedzser, Szerkesztő, Admin vagy Karbantartó szerepkörrel rendelkező felhasználók férhetnek hozzá ehhez a panelhez. A szerepkörök részletes leírásáért lásd a Jogosultságok áttekintése oldalt.

Új token generálása#

Adjon meg egy nevet, amely a token célját azonosítja.
Válasszon egy lejárati időszakot:
- 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 le a token értékét azonnal#

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

Új API token

⚠️ A token értéke később már nem lesz megtekinthető. A Procurize.AI csak egy biztonságos hash‑et tárol a hitelesítéshez. Ha elveszíti a tokenet, vissza kell vonnia és új tokent kell generálnia.

Meglévő tokenek kezelése#

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

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

Token deaktiválása / újraaktiválása#

Deaktiválás – ideiglenesen letiltja a tokenet. Szükség esetén később újraaktiválható.
Újraaktiválás – visszaállítja a korábban deaktivált tokenet aktív állapotba.

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

Token visszavonása#

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

API token használata#

Alap URL és hitelesítés#

Paraméter	Érték
Base 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‑azonosítóra – a token a szervezethez van kötve, így az API automatikusan feloldja a kontextust.

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

Szabály	Magyarázat
Token jogosultságok	A token pontosan ugyanazokkal a jogosultságokkal rendelkezik, mint a létrehozó felhasználó. Ha a felhasználó szerepköre változik, a token jogosultságai ennek megfelelően frissülnek.
Szervezeti kötés	A tokenek a létrehozó szervezethez vannak kötve. Nem használhatók több szervezet között.
Token láthatóság	A token értéke csak egyszer jelenik meg. Azonnal tárolja. A Procurize.AI csak egy hash‑et tárol.
Lejárt tokenek	A lejárt tokenek automatikusan deaktiválódnak, és nem használhatók. Szükség esetén generáljon új tokenet.

Hibakeresés#

Probléma	Megoldás
„Érvénytelen API kulcs” hiba	Ellenőrizze, hogy a token helyesen van másolva (nincsenek extra szóközök). 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ó aktuális szerepkörével. Ha a felhasználó elveszítette a jogosultságait, 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átok a csomagja alapján érvényesek. Ellenőrizze a válaszban található `X-RateLimit-*` fejléceket.

Kapcsolódó témák#

Jogosultságok áttekintése – részletes szerepkör-definíciók
Árazási csomagok – mely csomagok tartalmazzák az API hozzáférést
REST API referencia – részletes végpont dokumentáció