# 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

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

![API tokenek panel](/images/docs/api-tokens-panel.png)

> **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](/what-user-permissions-does-procurize-have/) oldalt.

## Új token generálása

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

3. 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](/images/docs/new-api-token.png)

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

```bash
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](/what-user-permissions-does-procurize-have/) – részletes szerepkördefiníciók  
- [Pricing Plans](https://www.procurize.ai/pricing/) – mely csomagok tartalmaznak API hozzáférést  
- [REST API Reference](/rest-api-reference/) – részletes végpont dokumentáció  

{{<article-feedback>}}