Помните! Что всю ответственность за финансовые операции несет сам пользователь.
Прежде чем приступать к работе на реальных счетах, рекомендуется протестировать функционал в "песочнице"
Для начала работы требуется подключить Тинькофф инвестиции и получить токен в личном кабинете.
В обработке требуется:
- указать используется рабочий API или функционал песочницы (определяется при получении токена)
- указать токен (токен сохраняется в настройках формы и заполнится при повторном открытии, в целях безопасности можете отключить это свойство)
- выбрать Сервис
- выбрать способ формирования запросов: с использованием процедур 1С или методов API
- выбрать из списка Процедуру или Метод
- заполнить при необходимости параметры
- нажать Выполнить запрос
Ответ сервера отображается в соответствующем поле в формате JSON
В обработке представлены все доступные на текущий момент (апрель 2024) методы работы с TinkoffAPI
При выборе Сервиса обновляется список методов и процедур, которые к нему относятся
При выборе Процедуры система отобразит нужное количество параметров с указанием имен и типов, а так же поля для ввода значений
При выборе Метода поля параметров автоматически не создаются, пользователь должен указать их самостоятельно
У пользователя всегда есть возможность добавить или удалить поля параметров с помощью гиперссылок Добавить параметр, Удалить параметр. Для значения параметра доступно четыре примитивных типа: строка, число, булево, дата
Немного о Процедурах 1С. Каждая из них
- соотносится с одним или несколькими методами TinkoffAPI
- возвращает Неопределено или массив/структуру, преобразованную из JSON-ответа
Пример процедуры с одним методом:
Пример процедуры с несколькими методами:
Некоторые особенности работы с TinkoffAPI
- активы имеют несколько идентификаторов (figi, uid, класс-код, тикер) и в разных методах могут использоваться разные идентификаторы
- если в документации в ответе сервера указано поле с нижним подчеркиванием, то в реальности оно пишется без подчеркивания ("instrument_id" -> "instrumentId")
- cистема устанавливает ограничения на количество запросов в минуту, значения которых можно получить методом GetUserTariff
- если есть в кармане пачка сигарет, значит всё не так уж плохо на сегодняшний день
Обработка
- выполнена на управляемых формах и соответственно может быть запущена только в режиме управляемого приложения
- имеет открытый код и может использоваться в ваших доработках
- не привязана к какой-либо конфигурации
- может функционировать на платформе 8.3.6 и выше
Справочные ресурсы TinkoffAPI:
- https://tinkoff.github.io/investAPI - справочная информация по работе с investAPI
- https://github.com/Tinkoff/investAPI - репозиторий / публичный архив файлов, в том числе прото-контрактов, примеров кода, документации, связанных с investAPI
- https://tinkoff.github.io/investAPI/grpc/ - описание gRPC-протокола
- https://tinkoff.github.io/investAPI/swagger-ui/ - описание REST-протокола
Может, кому пригодится. Доработки взаимодействия с TinkoffAPI на Infostart от других разработчиков:
Проверено на следующих конфигурациях и релизах:
- Бухгалтерия предприятия, редакция 3.0, релизы 3.0.151.27
