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‑ის მართვის პანელის გახსნა#

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

{title=“API token‑ების პანელი” alt=“API token‑ების პანელი”}

საჭირო უფლება: მხოლოდ Admin ან Maintainer როლების მქონე მომხმარებლებს შეუძლიათ მიიღონ წვდომა ამ პანელზე. როლების დეტალებისთვის იხილეთ Permissions Overview .

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

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

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

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

{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)#

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 – როლების დეტალური განსაზღვრები
Pricing Plans – რა პირობებზე შეიცავს API‑ის წვდომა
REST API Reference – დეტალურ Endpoints-ებზე დოკუმენტაცია