# API Token‑ები | Procurize.AI

**შექმენით, მართეთ და გამოიყენეთ API token‑ები უსაფრთხოდ პროგრამული წვდომისთვის თქვენი Procurize.AI სამუშაო სივრცეში.**

> **გამოყენებულია:** Procurize.AI Dashboard → Settings → Tokens  
> **ხელმისაწვდომია:** Business & Enterprise გეგმებში  
> **საჭირო როლი:** Admin ან Maintainer  

## საერთო მიმოხილვა

API token‑ები უზრუნველყოფენ უსაფრთხო, პროგრამული წვდომას Procurize.AI პლატფორმასთან. შეგიძლიათ გამოიყენოთ token‑ები, რათა ინტეგრირდეთ Procurize.AI‑ს თქვენს შიდა სისტემებთან, ავტომატურება სამუშაო პროცესებს, ან შექმნათ საკუთარი აპლიკაციები პლატფორმაზე.

**მნიშვნელოვან მახასიათებლებს შორის:**

- Token‑ები იღებთ **სრული უფლებას** იმ მომხმარებლის, რომელიც მათ შექმნა
- Token‑ები არის **ორგანიზაციის-შრეის** – არ არის საჭირო `org` მითითება API მოთხოვნებში
- შეუძლებელია შეზღუდული რაოდენობის token‑ის გენერაცია
- Token‑ებს შეიძლება არსებობდეს **ვადის თარიღები** ან შესაძლოა მოხდეს **უსასრულო მოქმედება**
- Token‑ებს შეიძლება იყოს **დეაქტივირებული** და საჭიროების მიხედვით **რეაქტივირებული**  

> 🔒 **უსაფრთხოების შენიშვნა:** Procurize.AI **არ** შენახავს token‑ის ღირებულებას – მხოლოდ მისი ჰეში. თქვენ იკვლეთ token‑ის სურვილი და უსაფრთხოდ ინახავთ მისი შექმნის შემდეგ. მასmore აღარ გამოჩნდება.

## Token‑ის მართვის პანელის გახსნა

1. გადადით **Dashboard** → **Settings** → **Tokens** ჩანართზე.  
2. Token‑ის მართვის პანელი აჩვენებს თქვენს პერსონალურ token‑ებს, რომლებიც მიმართულია მიმდინარე ორგანიზაციასთან.

![API token‑ების პანელი](/images/docs/api-tokens-panel.png){title="API token‑ების პანელი" alt="API token‑ების პანელი"}

> **საჭირო უფლება:** მხოლოდ **Admin** ან **Maintainer** როლების მქონე მომხმარებლებს შეუძლიათ მიიღონ წვდომა ამ პანელზე. როლების დეტალებისთვის იხილეთ [Permissions Overview](/what-user-permissions-does-procurize-have/) .

## ახალი Token-ის შექმნა

1. შეიყვანეთ **სახელი**, რომ დაინიშნოთ token‑ის მიზანი.  
2. აირჩეთ **ვადის დრო**:
   - 1 თვე
   - 3 თვე
   - 1 წელი
   - **არ არის ვადა** (უსასრულო მოქმედება)

3. დააწკაპეთ **"Generate"**.

### მნიშვნელოვანია – კოპირეთ Token დაუყოვნებლივ

Token-მა შექმნის შემდეგ **ერთხელ** მაჩვენებს ღირებულებას – მისი კოპირება და უსაფრთხოების ინახვა (მაგ. password manager-ში ან environment variable-ში) აუცილებელია.

![ახალი API token](/images/docs/new-api-token.png){title="ახალი API token" alt="ახალი API token"}

> ⚠️ **Token‑ის ღირებულება ერთჯერადად არის ხელმისაწვდომი.** Procurize.AI ინახავს მხოლოდ უსაფრთხო ჰეშს. თუ დაკარგეთ token‑ი, აუცილებელია მისი მოხსნა და ახალი შექმნა.

## არსებული Token-ებით სამუშავება

Token-ების პანელი აჩვენებს ყველა შექმნილ token-ებს შემდეგი სახით:

- სახელი
- სუფიქსი
- შექმნის თარიღი
- ვადის თარიღი (ან “-”)
- სტატუსი: **Active** ან **Inactive**

### Token-ის დეაქტივირება / რეაქტივირება

- **Deactivate** – დროებით გამორთავს token‑ს. შესაძლოა მოგვიანებით რეაქტივირდეთ.  
- **Reactivate** – გადაიტანს წინება დეაქტივირებულ token‑ს ხელახლა აქტივურ მდგომარეობაში.

> 💡 დეაქტივირება იგი დროებით ინტეგრაციების შეჩერებაა, token‑ის არღვევის გარეშე.

### Token-ის მოხსნა

- **Revoke** – სამუდამოდ წაშლის token‑ს. ქმედება გაუქმებული ვერ იქნება.  
- თუ დაკარგეთ token‑ი, ეხლა გადაიტანეთ მოხსნაზე და შექმენით ახალი.

## API Token-ის გამოყენება

### Base URL & Authentication

| პარამეტრი | მნიშვნელობა |
|-----------|-------------|
| **Base URL** | `https://api.procurize.com` |
| **Authentication method** | API გასაღები Header‑ში |
| **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‑მა აქვთ Exact‑საავე უფლებები, როგორც მომხმარებელს, ვინც მისი შექმნა, ასევე როლების ცვლილებისას ისახებათ. |
| **ორგანიზაციის ბინდინგი** | Token‑ები მიმაგრებულია შექმნის ორგანიზაციასთან. არ შეუძლიათ მრავალ ორგანიზაციაზე გამოყენება. |
| **Token-ის ხილვადობა** | Token‑ის ღირვამება **ერთჯერად**ა ჩანს. დაუყოვნებლივ შეინახეთ. Procurize.AI ინახავს მხოლოდ ჰეშს. |
| **მოძველებული Token-ები** | მოძველი token-ები ავტომატურად იდეაქტივირებულია და გამოყენება შეუძლებელია. საჭირო περίπτωση შექმენით ახალი token. |

## პრობლემების გადაჭრა

| პრობლემა | საკონმარლის |
|----------|--------------|
| **"Invalid API key" შეცდომა** | დარწმუნდით, რომ token‑ი სწორად დაკოპირებულია (არ არის დამატებითი სივრცე). შემოწმეთ token‑ის აქტიურობა და ვადის ტარდება. |
| **Token არ მუშაობს როლის შეცვლის შემდეგ** | Token-ის უფლება განახლებულია მიმდინარე როლის მიხედვით. თუ მომხმარებელს დაკარგა უფლება, token‑იც. |
| **გადატვირთული token** | მოხსნათ გადატვირთული token‑ი და შექმენით ახალი. |
| **Rate limiting** | API-ს შეცდომა მუშაობის მიმართულებითა计划ის მიხედვით. შეამოწმეთ `X-RateLimit-*` ჰედერები პასუხში. |

## დაკავშირებული თემები

- [Permissions Overview](/what-user-permissions-does-procurize-have/) – როლების დეტალური განსაზღვრები  
- [Pricing Plans](https://www.procurize.ai/pricing/) – რა პირობებზე შეიცავს API‑ის წვდომა  
- [REST API Reference](/rest-api-reference/) – დეტალურ Endpoints-ებზე დოკუმენტაცია  

{{<article-feedback>}}