Нужен токен с доступом на выставление поручений: где выпустить, как сохранить, срок жизни и замена.
Какой токен нужен
Для работы сервиса нужен токен с доступом на выставление поручений, то есть Full-access. Токен только для чтения не подойдет: сервис сможет посчитать сделки, но не сможет их выполнить.
Переводы между счетами сервису не нужны, поэтому право на переводы не требуется. Если есть возможность ограничить токен одним брокерским счетом, используйте ее.
Где выпустить
Токен выпускается только на сайте Т-Банка. Управлять токенами удобнее с компьютера: при работе с телефона возможна переадресация в мобильное приложение, где раздела токенов нет. В этом случае откройте ссылку в браузере через пункт Открыть в новой вкладке.
Перейдите в настройки профиля Т-Инвестиций и авторизуйтесь, если потребуется. Функция подтверждения сделок кодом должна быть отключена, иначе выпуск и работа через API будут недоступны. Сделки на сумму более 30 000 000 рублей через API недоступны.
Как выпустить и сохранить
Выпустите токен T-Invest API для биржи. Возможно, система попросит авторизоваться еще раз, это нужно для подключения к торговой платформе. Скопируйте токен сразу: он показывается только один раз, позже посмотреть его нельзя.
Затем вставьте токен в сервисе: в веб-приложении или в Telegram-боте в настройках подключения брокера. Количество токенов не ограничено, для сервиса лучше выпустить отдельный токен.
Срок жизни и обновление
Срок жизни токена - три месяца с даты последнего использования. Новый токен нужно начать использовать в первые 7 дней после выпуска, иначе он будет отозван. Если обращение идет с неактуальным токеном, вернется ошибка 40003.
Поэтому токен желательно обновлять каждые пару месяцев: выпустите новый, вставьте в сервис, старый отзовите. Так вы не попадете на просроченный токен перед плановой балансировкой.
Как посмотреть и отозвать
Список активных токенов виден на странице безопасности в разделе приложений с доступом к данным для входа. Там же видны дата выпуска, дата последнего использования и права доступа.
Для отзыва откройте личный кабинет, раздел Настройки, плашку Токены T-Bank Invest API, далее Список токенов, выберите токен и нажмите Удалить доступ.
Токен с торговыми правами позволяет совершать сделки, поэтому не передавайте его третьим лицам. При подозрении на компрометацию отзовите токен и выпустите новый. Подробнее - в документации Т-Банка.