# API Tokenid | Procurize.AI

**Loo, halda ja kasuta API tokenid turvalise programmeerimise juurdepääsu jaoks oma Procurize.AI tööruumis.**

> **Kohaldub:** Procurize.AI Töölaud → Seaded → Tokenid  
> **Saadaval on:** Business & Enterprise plaanid  
> **Nõutav roll:** Admin või Maintainer

## Ülevaade

API tokenid võimaldavad turvalist programmeerimist juurdepääsu Procurize.AI platvormile. Saad kasutada tokenid integratsioonide loomiseks oma sisemiste süsteemidega, töövoogude automatiseerimiseks või kohandatud rakenduste ehitamiseks platvormil põhinevalt.

**Peamised omadused:**

- Tokenid pärivad **kõik õigused** kasutajalt, kes need on loonud
- Tokenid on **organisatsiooniulatus** – pole vaja API päringutes `org` määrata
- Lõpmatu arv tokeneid saab genereerida
- Tokenitel võib olla **aegumiskuupäev** või need võivad olla määramata ajaliselt kehtivad
- Tokenid võivad olla **deaktiveeritud** ja vajadusel **reaktiveeritud** 

> 🔒 **Turvalisuse märkus:** Procurize.AI **ei** salvesta tokeni väärtust – ainult selle räsi. Pead tokeni kohe genereerimisel kopeerima ja turvaliselt salvestama. See ei kuvata enam kordagi.

## Tokenite Halduse Paneeli Avamine

1. Navigeeri **Töölaud** → **Seaded** → **Tokenid** vahekaardile.  
2. Tokenite halduse paneel näitab sinu isiklikke tokenid, mis on seotud praeguse organisatsiooniga.

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

> **Nõutav õigus:** Ainult kasutajad, kellel on **Admin** või **Maintainer** roll, saavad sellele paneelile ligi. Täpsema rollide kirjelduse leiad lehelt [Õiguste Ülevaade](/what-user-permissions-does-procurize-have/) .

## Uue Tokeni Loo

1. Sisesta **Nimi**, et määrata tokeni otstarve.  
2. Vali **aegumisperiood**:
   - 1 kuu
   - 3 kuud
   - 1 aasta
   - **Pole aegumiskuupäeva** (piiramatu kehtivus)

3. Klõpsa **"Loo"**.

### Oluline – Kopeeri Token Koheselt

Pärast genereerimist kuvatakse tokeni väärtust **ainult üks kord** – kopeeri see ja salvesta turvaliselt (nt paroolihalduris või keskkonnamuutujas).

![Uus API token](/images/docs/new-api-token.png)

> ⚠️ **Sa ei saa tokeni väärtust enam kunagi vaadata.** Procurize.AI salvestab ainult turvalise räsi kontrollimise eesmärgil. Kui kaotad tokeni, pead selle tühistama ja looma uue.

## Olemasolevate Tokenite Halduse

Tokenite paneel näitab loendit kõigist genereeritud tokenitest, mis sisaldavad:

- Nimi
- Lõpp
- Loomise kuupäev
- Aegumiskuupäev (või "-")
- Staatus: **Aktiivne** või **Mitteaktiivne**

### Deaktiveerimine / Reaktiveerimine

- **Deaktiveeri** – ajutiselt keelab tokeni. Vajadusel saab selle hiljem taasaktiveerida.  
- **Reaktiveeri** – taastab varem deaktiveeritud tokeni aktiivseks.

> 💡 Deaktiveerimine on kasulik integratsioonide ajutiseks peatamiseks ilma tokenit kustutamata.

### Tokeni Tühistamine

- **Tühista** – kustutab tokeni püsivalt. Selle tegevust ei saa tagasi võtta.  
- Kui kaotad tokeni, tühista see kohe ja loo uus.

## API Tokeni Kasutamine

### Baas-URL ja Autentimine

| Parameeter   | Väärtus                     |
|--------------|-----------------------------|
| **Baas-URL** | `https://api.procurize.com` |
| **Autentimise meetod** | API key via header |
| **Päis** | `X-API-Key: <YOUR_API_TOKEN>` |

### Näide Päringust (cURL)

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

> 🧠 **Organisatsiooni ID-d pole vaja** – token on seotud sinu organisatsiooniga, seega API tuvastab konteksti automaatselt.

## Olulised Turvalisus- ja Kasutusreeglid

| Reegel                     | Selgitus                                                                                                                                                     |
|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Tokeni õigused**         | Tokenil on täpselt samad õigused, mis kasutajal, kes selle lõi. Kui kasutaja roll muutub, uuenevad tokeni õigused automaatselt.                               |
| **Organisatsiooni sidumine** | Tokenid on seotud loojate organisatsiooniga. Sa ei saa tokenit kasutada erinevate organisatsioonide vahel.                                                   |
| **Tokeni nähtavus**        | Tokeni väärtust näidatakse **ainult üks kord**. Salvesta see kohe. Procurize.AI salvestab ainult räsi.                                                       |
| **Aegunud tokenid**        | Aegunud tokenid des aktiveeritakse automaatselt ja neid ei saa kasutada. Vajadusel loo uus token.                                                          |

## Probleemide Lahendamine

| Probleem                     | Lahendus                                                                                                                                                 |
|------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|
| **"Invalid API key" viga**   | Kontrolli, et token on õigesti kopeeritud (ilma lisasõnadeta). Veendu, et token on endiselt aktiivne ja pole aegunud.                                      |
| **Token ei tööta pärast rolli muutmist** | Tokeni õigused uuendatakse vastavalt kasutaja praegusele rollile. Kui kasutaja kaotas õigused, kaotab token ka need.                                        |
| **Kaotatud token**           | Tühista kaotatud token ja loo uus.                                                                                                                       |
| **Kiiruse piirang**          | API kiiruse piiranguid kehtib vastavalt sinu plaanile. Kontrolli vastuses `X-RateLimit-*` päiseid.                                                      |

## Seotud Teemad

- [Õiguste Ülevaade](/what-user-permissions-does-procurize-have/) – detailne rollide kirjeldus  
- [Hinnaplaanid](https://www.procurize.ai/pricing/) – millised plaanid sisaldavad API juurdepääsu  
- [REST API Viide](/rest-api-reference/) – üksikasjalik endpointide dokumentatsioon  

{{<article-feedback>}}