API токени | Procurize.AI#

Създавайте, управлявайте и използвайте API токени за сигурен програматичен достъп до вашето работно пространство в Procurize.AI.

Отнася се за: Procurize.AI Табло → Настройки → Токени
Налично в: плановете Business & Enterprise
Необходима роля: Security Manager, Editor, Admin или Maintainer

Преглед#

API токените осигуряват сигурен, програматичен достъп до платформата Procurize.AI. Можете да ги използвате за интеграция с вътрешните си системи, автоматизиране на работни процеси или създаване на персонализирани приложения върху платформата.

Ключови характеристики:

• Токените наследяват всички разрешения на потребителя, който ги е създал
• Токените са обхващащи организацията – не е необходимо да се указва org в API заявките
• Могат да се създадат неограничен брой токени
• Токените могат да имат дата на изтичане или да бъдат безсрочни
• Токените могат да бъдат деактивирани и по-късно реактивирани при нужда

🔒 Забележка за сигурност: Procurize.AI не съхранява стойността на токена – само неговия хеш. Трябва незабавно да копирате и запазите токена след генериране. Той няма да бъде показан отново.

Достъп до панела за управление на токени#

1. Отидете до страницата Dashboard → API Tokens.
2. Панелът за управление на токени показва вашите лични токени, свързани с текущата организация.

Необходима разрешение: Само потребители с роли Security Manager, Editor, Admin или Maintainer могат да достъпят този панел. За подробни дефиниции на ролите, вижте Преглед на разрешенията .

Създаване на нов токен#

1. Въведете Име, за да идентифицирате целта на токена.

2. Изберете период на изтичане:

   • 1 месец
   • 3 месеца
   • 1 година
   • Без изтичане (неограничена валидност)

3. Натиснете „Generate“.

Важно – Копирайте токена незабавно#

След генериране стойността на токена се показва веднъж – копирайте я и я съхранете сигурно (например в мениджър за пароли или като променлива на средата).

⚠️ Няма да можете да видите стойността на токена отново. Procurize.AI съхранява само сигурен хеш за проверка. Ако загубите токена, трябва да го анулирате и да създадете нов.

Управление на съществуващи токени#

Панелът Токени показва списък с всички създадени токени със следните данни:

• Име
• Суфикс
• Дата на създаване
• Дата на изтичане (или „-“)
• Статус: Активен или Неактивен

Деактивиране / Реактивиране на токен#

• Deactivate – временно деактивира токена. Можете да го реактивирате по-късно при нужда.
• Reactivate – възстановява преди това деактивиран токен в активен статус.

💡 Деактивирането е полезно за временно спиране на интеграции без изтриване на токена.

Анулиране на токен#

• Revoke – окончателно изтрива токена. Това действие не може да бъде отменено.
• Ако загубите токен, анулирайте го незабавно и създайте нов.

Използване на API токен#

Основен URL и автентикация#

Примерна заявка (cURL)#

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

🧠 Не е необходим ID на организацията – токенът е свързан с вашата организация, така че API автоматично определя контекста.

Важни правила за сигурност и използване#

Отстраняване на проблеми#

Свързани теми#

• Преглед на разрешенията – подробни дефиниции на ролите
• Ценови планове – кои планове включват достъп до API
• REST API справочник – подробна документация за крайни точки