# API Token-ներ | Procurize.AI

**Ստեղծեք, կառավարեք և օգտագործեք API token-ները ապահով ծրագրային մատչություն ձեր Procurize.AI աշխատանքային տարածքին।**

> **Պատկանում է:** Procurize.AI Գործիքավճար → Կարգավորումներ → Token-ներ  
> **Մատչելի է:** Business և Enterprise պլանների համար  
> **Պարտադիր դերը:** Ադմին կամ Մակնարդակ

## Գլխավոր դիտված

API token-ները հնարավորություն են տալիս ապահով, ծրագրային հասանելիություն Procurize.AI պլատֆորմին։ Դուք կարող եք օգտագործել token-ները՝ ինտեգրելու Procurize.AI-ը ձեր ներքին համակարգերով, ավտոմատացնել գործընթացները, կամ կառուցել հատուկ ծրագիրների վերամշակվածը պլատֆորմի վրա:

**Կրակին հատկություններ՝**

- Token-ները ժառանգում են **բոլոր թույլտվությունները** օգտատիրոջ, որը դրանք ստեղծեց  
- Token-ները **կազմակերպության շրջանակով են** – `org` նիշը չի անհրաժեշտ API կանչում  
- Անսահմանափակ token-ները կարող են ստեղծվել  
- Token-ները կարող են ունենալ **ժամկետավորման ամսաթվեր** կամ սահմանված չերևակայելու  
- Token-ները կարող են **ակտիվացում չպատրաստվելու** և հետագայում **վերակտիվացում** ըստ կարիքների  

> 🔒 **Անվտանգության նշում:** Procurize.AI **չկպչում** token-ի արժեքը – միայն նրա հեշը։ Դուք պետք է պատճենեք և պահեք token-ը անմիջապես ստեղծման հետո։ Այն այլևս չի ցուցադրվի։

## Token-ների Կառավարման Պանետի Մուտք

1. Անվճար ընտրեք **Գործիքավճարը** → **Կարգավորումներ** → **Token-ներ** ներդիրը։  
2. Token-ների կառավարման պեղը ցույց է տալիս ձեր անձնական token-ները, որոնք կապված են ընթացիկ կազմակերպության հետ։

![API token-ների պանել](/images/docs/api-tokens-panel.png)

> **Անհրաժեշտ թույլտվություն:** Միայն **Ադմին** կամ **Մակնարդակ** դերի օգտատերերը կարող են մուտք գործել այս պեղը։ Հասկացման համար, տես [Թույլտվությունների Ընդլայնված Խորհրդատվություն](/what-user-permissions-does-procurize-have/)։

## Նոր Token Խմբավորելը

1. Տարբեք **ԱՆվան** token-ի նպատակակազմի համար։  
2. Ընտրեք **ժամկետի տևողություն**՝  
   - 1 ամիս  
   - 3 ամիս  
   - 1 տարի  
   - **Չունի ժամկետ** (անկսպառություն)  

3. Սեղմեք **«Ստեղծել»**։

### Կարևոր — Պատճենեք Token-ը անմիջապես

Ստեղծվելուց հետո token-ի արժեքը **արտածվում է մեկ անգամ** – պատճենեք այն և պահեք այն անվտանգ (օրինակ՝ գաղտնաբառի կառավարիչում կամ միջավայրային փոփոխականի մեջ)։

![Նոր API token](/images/docs/new-api-token.png)

> ⚠️ **Դուք այլևս չեք կարող տեսնել token-ի արժեքը:** Procurize.AI պահում է միայն ապահով հեշ հավաստիացման համար। Եթե կորցնեք token-ը, պետք է չեղարկեք այն և ստեղծեք նորը։

## Գոյություն ունեցող Token-ների Կառավարում

Token-ների պեղը ցույց է տալիս բոլոր ստեղծված token-ների ցանկը՝

- Անուն  
- Վերջում  
- Ստեղծման ամսաթիվ  
- Ժամկետավորման ամսաթիվ (կամ "-")  
- Ստատուս: **Ակտիվ** կամ **Աակտիվ**  

### Ակտիվացնել / Վերակտիվացնել Token-ը

- **Ակտիվացնել** – ժամանակավորապես անջատում token-ը։ Կարող եք հետագայում վերակտիվացնել այն, երբ հարկավոր է։  
- **Վերակտիվացնել** – վերականգնում token-ը, որը առաջակտիվացվել է, ակտիվ վիճակին։

> 💡 Ակտիվացումը օգտակար է ժամանակավոր ինտեգրումների կասեցման համար, առանց token-ի ջնջելու։

### Չեղարկել Token

- **Չեղարկել** – մշտապես ջնջում token-ը։ Այս գործողությունը չի կարելի չհաստատել։  
- Եթե կորցնում եք token, չեղարկեք այն անմիջապես և ստեղծեք նորը։

## API Token-ի օգտագործում

### Բազական URL & Ավտորիզացիա

| Պարամետր               | Արժեք                     |
|------------------------|---------------------------|
| **Base URL**           | `https://api.procurize.com` |
| **Authentication method** | API բանալի գլխամասի միջոցով |
| **Header**             | `X-API-Key: <YOUR_API_TOKEN>` |

### Օրինակ Հարցում (cURL)

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

> 🧠 **Կազմակերպության ID չի պահանջվում** – token-ը կապված է ձեր կազմակերպությանը, ուստի API-ն ինքնաբերաբար հայտնաբերում է կոնտեքստը։

## Կարևոր Անվտանգության և Օգտագործման Կաʍղեր

| Կարգ                         | Բացատրություն                                                                                                                                               |
|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Token-ի թույլտվություններ** | Token-ը ունի ճիշտ նույն թույլտվությունները, ինչն ունի օգտատերը, որը այն ստեղծեց։ Եթե օգտատիրոջ դերը փոխվի, token-ի թույլտվությունները թարմացվում են ըստ դրա: |
| **Կազմակերպության կապակցվածություն** | Token-ները կապված են ստեղծողի կազմակերպության հետ։ Դուք չեք կարող օգտագործել token-ը մի քանի կազմակերպությունների վրա:                                          |
| **Token-ի տեսանելիություն** | Token-ի արժեքը ցուցադրվում է **մեկ անգամ**։ Պահեք այն անմիջապես։ Procurize.AI պահում է միայն հեշը:                                                          |
| **ՎԱԾված Token-ները**        | ՎԱԾված token-ները ավտոմատ կերպով վճարադրվում են և չեն կարող օգտագործվել։ Անհրաժեշտության դեպքում ստեղծեք նոր token:                                      |

## Проблемների լուծումները

| Խնդիր                           | Դարձված լուծում                                                                                                                                                                  |
|---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **«Անվավեր API բանալի» սխալ**   | Ստուգեք, որ token-ը ճիշտ պատճենված է (առավել չպարունակելով բացատները). Համոզվեք, որ token-ը դեռ ակտիվ է և չի վերացված:                                                            |
| **Token-ը չի աշխատում դերը փոխելուց հետո** | Token-ի թույլտվությունները թարմացվում են՝ համադրվելը օգտագործողի ընթացիկ դերին։ Եթե օգտատիրոջը բացակայում են թույլտվություններ, token-ը նույնպես կկորչի:                              |
| **Կորցված token**               | Չեղարկեք կորած token-ը և ստեղծեք նորը։                                                                                                                                           |
| **Արագության սահմանափակում**    | API-ի արագության սահմանափակումները կիրառվում են ձեր պլանի համաձայն։ Ստուգեք `X-RateLimit-*` գլխամասները պատասխանումում:                                                            |

## Կապված Թեմաներ

- [Թույլտվությունների Ընդլայնված Խորհրդատվություն](/what-user-permissions-does-procurize-have/) – մանրամասն դերի սահմանումներ  
- [Գնի պլաններ](https://www.procurize.ai/pricing/) – որոնք պլանները ներառում են API մատչություն  
- [REST API Գրանցում](/rest-api-reference/) – մանրամասն endpoint-երի փաստաթղթեր  

{{<article-feedback>}}