> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tungo.kz/llms.txt
> Use this file to discover all available pages before exploring further.

# Что такое платформа Tungo

> Для чего нужна платформа Tungo, что можно сделать по ключу API и чем она отличается от кабинета.

Платформа 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 тиын.

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

> [card] [Создать ключ API](https://docs.tungo.kz/platform/api-keys.md)
>
> Кто выпускает ключ, какие права ему дать и что делать, если ключ попал не в те руки.

> [card] [Сделать первый запрос](https://docs.tungo.kz/platform/first-request.md)
>
> Проверить ключ, узнать id компании и задать вопрос ИИ-бухгалтеру.

> [card] [Получать события](https://docs.tungo.kz/platform/webhooks.md)
>
> Добавить адрес своего сервера, проверить подпись и разобраться с повторами.

> [card] [Баланс и расход](https://docs.tungo.kz/platform/balance.md)
>
> Как пополняется баланс, где смотреть расход и как ограничить траты.

> [card] [Ошибки и ограничения](https://docs.tungo.kz/platform/errors-and-limits.md)
>
> Как устроен ответ об ошибке, главные коды и ограничение частоты запросов.

> [card] [Автоматизации](https://docs.tungo.kz/automations/overview.md)
>
> Сценарии, которые запускают ИИ-бухгалтера по расписанию или по событию.

## Что дальше

* [Создать ключ API](https://docs.tungo.kz/platform/api-keys.md): первый шаг для любой интеграции.
* [Сделать первый запрос](https://docs.tungo.kz/platform/first-request.md): от ключа до ответа ИИ-бухгалтера.
* [Ключ не работает](https://docs.tungo.kz/platform/key-not-working.md): если запрос вернул отказ.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.