Перейти к основному содержанию
Платформа Tungo нужна, чтобы подключить Tungo к своей системе: учётной программе, CRM, сайту или боту. Ваш сервер обращается к API с ключом и получает то же, что человек получает в кабинете: ответы ИИ-бухгалтера по данным 1С, подготовленные документы, события о том, что произошло. В кабинете работает человек: он входит по почте, пишет в чат и нажимает кнопки. На платформе работает программа: она присылает запросы на https://api.tungo.kz и подтверждает себя ключом вида tg_…. Экраны платформы открываются из кабинета по ссылке Платформа в меню. Там выпускают ключи, пополняют баланс и смотрят расход. Счёт и ключи видят только владелец и администратор организации.

​
Что можно сделать по ключу

Ключ выпускается для одной организации и работает с её компаниями: со всеми или только с выбранными. Что именно разрешено, задают права ключа при выпуске.
  • Задать вопрос ИИ-бухгалтеру компании и получить ответ целиком или потоком событий.
  • Прочитать очередь документов, которые ИИ-бухгалтер подготовил для 1С, одобрить документ или отклонить.
  • Отдать на разбор банковскую выписку и входящие ЭСФ.
  • Настроить автоматизации компании: сценарии, входящие хуки, запуски.
  • Завести адреса для вебхуков и получать на них события.
  • Узнать баланс платформы, расход, цены моделей и свои пределы.
Полный список адресов, полей и ответов есть в справочнике API. Он собирается из того же описания, которое отдаёт адрес https://api.tungo.kz/v1/openapi.json. Это описание можно загрузить в свой инструмент или сгенерировать по нему клиента.

​
Чего по ключу сделать нельзя

Выпускать, менять и отзывать ключи может только человек в кабинете. По ключу эти адреса не работают. То же касается пополнения баланса, настроек платформы, карт, сотрудников и подключения 1С. Состояние подключения 1С ключ прочитать может, поменять его нельзя. Из браузера API не вызывается. Ключ является секретом, и хранить его нужно на своём сервере. Запросы из кода страницы на чужом сайте получают отказ 403 с кодом cors_not_supported. Ключ действует от имени того, кто его выпустил, и никогда не шире его прав. Отдельной песочницы и тестовых ключей нет: запросы идут к настоящей компании и оплачиваются с настоящего баланса.

​
Отдельный баланс

Запросы к ИИ-бухгалтеру по ключу и автоматизации оплачиваются с баланса платформы. Он отдельный от подписки: подписка для платформы не нужна, а лимиты тарифа на запросы по ключу не действуют. Деньги списываются за каждый вызов модели по ценам за токены. Суммы в API указаны в тиынах, 1 ₸ = 100 тиын.

​
С чего начать

Создать ключ API

Кто выпускает ключ, какие права ему дать и что делать, если ключ попал не в те руки.

Сделать первый запрос

Проверить ключ, узнать id компании и задать вопрос ИИ-бухгалтеру.

Получать события

Добавить адрес своего сервера, проверить подпись и разобраться с повторами.

Баланс и расход

Как пополняется баланс, где смотреть расход и как ограничить траты.

Ошибки и ограничения

Как устроен ответ об ошибке, главные коды и ограничение частоты запросов.

Автоматизации

Сценарии, которые запускают ИИ-бухгалтера по расписанию или по событию.

​
Что дальше