API Token-ები | Procurize.AI#

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

განაცხადის ობიექტი: Procurize.AI დაფა → პარამეტრები → Token-ები
ხელმისაწვდომია: Business & Enterprise გეგმებზე
საჭირო როლები: უსაფრთხოების მენეჯერი, რედაქტორი, ადმინისტრატორი ან მოვლა‑მმართველი

მიმოხილვა#

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

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

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

🔒 უსაფრთხოების შენიშვნა: Procurize.AI არ ინახავს token-ის ღირებულებას – მხოლოდ მისი ჰეშს. თქვენ უნდა დაკოპიროთ და შეინახოთ token-ი დაუყოვნებლივ გენერაციის შემდეგ. იგი აღარ გამოჩნდება.

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

1. გადადით დაფაზე → API Token-ები გვერდზე.
2. Token‑ების მართვის პანელი აჩვენებს თქვენს პერსონალურ token‑ებს, რომლებიც დაკავშირებულია მიმდინარე ორგანიზაციასთან.

{title=“API token-ების გვერდი”}

საჭირო უფლება: მხოლოდ მომხმარებლებს, რომელთაც აქვთ უსაფრთხოების მენეჯერის, რედაქტორის, ადმინისტრატორის ან მოვლა‑მმართველის როლები, შეუძლიათ ამ პანელში შესვლა. როლების დეტალურ აღწერაზე იხილეთ უფლებების მიმოხილვა .

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

1. შეიყვანეთ სახელი, რომელიც აღწერს token-ის მიზანს.

2. აირჩიეთ ვადის გასვლის პერიოდი:

   • 1 თვე
   • 3 თვე
   • 1 წელი
   • ვადა არ აქვს (უსასრულო მოქმედება)

3. დააწკაპეთ “Generate” ღილაკს.

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

გენერაციის შემდეგ token-ის ღირებულება ერთჯერადად გამოჩნდება – დაკოპირეთ იგი და შეინახეთ უსაფრთხოდ (მაგ. პაროლების მმართველში ან გარემოს ცვლადში).

{title=“ახალი API token”}

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

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

Token‑ების პანელი აჩვენებს ყველა შექმნილ token‑ს, რომელთა:

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

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

• დეაქტივირება – დროებით გამორთავს token-ს. საჭიროების შემთხვევაში შეგიძლიათ მისი რეაქტივირება.
• რეაქტივირება – აღდგება ადრე დეაქტივირებული token, გადადის აქტიურ მდგომარეობაში.

💡 დეაქტივირება სასარგებლოა ინტეგრაციების დროებით შეჩერებისთვის, token-ის წაშლის გარეშე.

Token-ის გაუქმება#

• გაუქმება – მუდმივად წაშლის token-ს. მოქმედება შეუქცევადია.
• თუ დაკარგავთ token-ს, დაუყოვნებლივ გაუქმეთ იგი და შექმნათ ახალი.

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

საბაზისო URL & აუტენტიკაცია#

მოთხოვნის მაგალითი (cURL)#

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

🧠 ორგანიზაციის ID არ არის საჭირო – token-ი მიბმულია თქვენს ორგანიზაციას, ამიტომ API ავტომატურად განსაზღვრავს კონტექსტს.

მნიშვნელოვანი უსაფრთხოების & გამოყენების წესები#

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

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

• უფლებების მიმოხილვა – როლების დეტალური აღწერა
• ფასის გეგმები – რომელ გეგმებში შედის API წვდომა
• REST API დოკუმენტაცია – Endpoints-ის დეტალური აღწერა