Токены API | Procurize.AI#

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

Применяется к: Панель управления Procurize.AI → Настройки → Токены
Доступно в: тарифах Business и Enterprise
Требуемая роль: Менеджер по безопасности, Редактор, Администратор или Сопровождающий

Обзор#

Токены API обеспечивают безопасный программный доступ к платформе Procurize.AI. Вы можете использовать токены для интеграции Procurize.AI с вашими внутренними системами, автоматизации рабочих процессов или создания пользовательских приложений на основе платформы.

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

Токены наследуют все разрешения пользователя, создавшего их
Токены имеют область действия организации — нет необходимости указывать org в API‑запросах
Можно создать неограниченное количество токенов
Токены могут иметь даты истечения или быть без срока действия
Токены могут быть деактивированы и позже реактивированы по необходимости

🔒 Примечание по безопасности: Procurize.AI не хранит значение токена — только его хеш. Вы должны сразу скопировать и сохранить токен после его создания. Он больше не будет отображён.

Доступ к панели управления токенами#

Перейдите на страницу Панель управления → Токены API.
Панель управления токенами отображает ваши личные токены, связанные с текущей организацией.

Страница токенов API

Требуемое разрешение: Только пользователи с ролями Менеджер по безопасности, Редактор, Администратор или Сопровождающий могут получить доступ к этой панели. Подробные определения ролей см. в разделе Обзор разрешений .

Создание нового токена#

Введите Имя, чтобы обозначить назначение токена.
Выберите период действия:
- 1 месяц
- 3 месяца
- 1 год
- Без срока действия (неограниченная валидность)
Нажмите «Создать».

Важно – Скопируйте токен сразу#

После создания значение токена отображается один раз — скопируйте его и надёжно сохраните (например, в менеджере паролей или переменной окружения).

Новый токен API

⚠️ Вы больше не сможете увидеть значение токена. Procurize.AI хранит только безопасный хеш для проверки. Если вы потеряете токен, вам нужно отозвать его и создать новый.

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

Панель Токены отображает список всех созданных токенов со следующими данными:

Имя
Суффикс
Дата создания
Дата истечения (или «-»)
Статус: Активен или Неактивен

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

Деактивировать – временно отключает токен. Вы можете реактивировать его позже при необходимости.
Реактивировать – возвращает ранее деактивированный токен в активный статус.

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

Отзыв токена#

Отозвать – полностью удаляет токен. Это действие нельзя отменить.
Если вы потеряете токен, отзовите его немедленно и создайте новый.

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

Базовый URL и аутентификация#

Параметр	Значение
Base URL	`https://api.procurize.com`
Метод аутентификации	API‑ключ в заголовке
Заголовок	`X-API-Key: <YOUR_API_TOKEN>`

Пример запроса (cURL)#

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

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

Важные правила безопасности и использования#

Правило	Объяснение
Разрешения токена	Токен имеет точно такие же разрешения, как пользователь, создавший его. Если роль пользователя меняется, разрешения токена обновляются соответственно.
Привязка к организации	Токены привязаны к организации создателя. Вы не можете использовать токен в нескольких организациях.
Видимость токена	Значение токена показывается только один раз. Сохраните его сразу. Procurize.AI хранит только хеш.
Истёкшие токены	Истёкшие токены автоматически деактивируются и не могут быть использованы. При необходимости создайте новый токен.

Устранение неполадок#

Проблема	Решение
Ошибка «Invalid API key»	Проверьте, что токен скопирован правильно (без лишних пробелов). Убедитесь, что токен активен и не истёк.
Токен не работает после изменения роли	Разрешения токена обновляются в соответствии с текущей ролью пользователя. Если у пользователя исчезли разрешения, токен тоже их теряет.
Потерян токен	Отзовите потерянный токен и создайте новый.
Ограничение скорости	Ограничения API зависят от вашего тарифа. Проверьте заголовки `X-RateLimit-*` в ответе.

Связанные темы#

Обзор разрешений – подробные определения ролей
Тарифные планы – какие тарифы включают доступ к API
Справочник REST API – подробная документация по эндпоинтам