API токены

API токены используются для аутентификации при работе с REST API. Каждый токен предоставляет доступ к ресурсам вашего аккаунта через API.

Управление токенами доступно в разделе API токены.

Чтобы создать новый API токен:

1. Откройте раздел API токены
2. Нажмите "Создать токен"
3. Укажите название токена (для удобной идентификации)
4. При необходимости укажите дату истечения
5. Сохраните токен

После создания токена он будет отображен один раз. Сохраните его в безопасном месте, так как позже получить его будет невозможно.

Токен передается в заголовке запроса при работе с API:

Authorization: Bearer YOUR_API_TOKEN

Пример curl запроса:

curl -X POST https://your-domain.com/api/v1/agents/BOT_UUID/trigger \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message": "Привет!"}'

API токены — это секретная информация. Следуйте рекомендациям:

• Не делитесь токенами — они должны быть известны только вам
• Не коммитьте токены в репозитории
• Используйте разные токены для разных приложений или целей
• Устанавливайте срок действия для токенов, если это возможно
• Отключайте неиспользуемые токены для уменьшения поверхности атаки
• Регулярно обновляйте токены при подозрении на компрометацию

Если токен скомпрометирован, немедленно отключите его и создайте новый.

В разделе API токенов вы можете:

• Просматривать список всех токенов
• Видеть активные и отключенные токены
• Отключать токены (деактивировать)
• Просматривать информацию о токенах (название, дата создания, срок действия)

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