Интеграция в приложение

Настольное приложение

Рекомендуемый вариант — дочерний процесс на окно или контролируемую группу книг. Держите stdin/stdout открытыми, сопоставляйте один запрос одному ответу, пишите в журнал operation и code, но не содержимое ячеек.

Сервер

Оборачивайте программу командной строки собственной службой. На запрос загрузки создавайте изолированный рабочий каталог, запускайте процесс с ограничением по памяти и времени, выдавайте наружу свой признак сеанса и никогда не показывайте клиенту subsetId — это внутреннее имя открытого сеанса книги, живущее только внутри процесса ядра.

Браузер

Браузер напрямую не запускает compute_contract_cli: ядро — обычный исполняемый файл, и со страницы его вызвать нельзя. Рабочая схема сегодня одна: оболочка работает в браузере, процесс ядра — на вашей стороне, между ними постоянное соединение. Так устроен живой пример — книга открыта отдельным процессом, а страница показывает лист и передаёт действия. Набора, который можно поставить пакетом и вызывать прямо со страницы, это руководство не обещает: что в него войдёт, описано в наборе для встраивания.

Телефон и планшет

На iOS и Android используйте серверный вариант или адаптер, собранный под саму платформу. Не кладите настольный процессор в мобильное приложение и не запускайте его как произвольный процесс: правила изоляции на телефоне этого не допускают.

Рекомендуемая форма вашего API

POST   /workbooks               → свой признак сеанса
POST   /workbooks/{id}/commands → типизированный ответ
GET    /workbooks/{id}/cells    → участок листа, а не весь лист
POST   /workbooks/{id}/save     → файл или ссылка на скачивание
DELETE /workbooks/{id}          → закрыть сеанс и убрать за собой

Безопасность

Разрешайте только заранее заданные каталоги и типы файлов. Не передавайте destinationUri, пришедший от внешнего клиента, прямо в программу командной строки: адрес назначения должен собираться на вашей стороне.

Дальше по теме

• Полный список операций с полями — справочник Compute Contract.
• Что приходит в ответе и как читать отказ — Как устроен сеанс API.
• Перед пилотом — контрольный список готовности.