Backend и Data API

Свободный интерфейс.
Структурированный бэкенд.

CosmoApps можно использовать целиком или только как слой данных и API. Runtime — удобный готовый клиент, но не обязательная оболочка.

ДокументыData APIJOINЛокальный контур
COSMOAPPSМодель + данныеmetadata · documents · security · Data API
01RuntimeERP · CRM · админка
02Веб-приложениесайт · кабинет · SaaS
03Мобильный клиенткурьеры · выездные команды
Один backend. Разные интерфейсы.

Три нормальных способа использовать платформу

Выбирайте не идеологию, а самый дешёвый путь для конкретного интерфейса.

01

Только Runtime

Для ERP, CRM, справочников и внутренних систем, где стандартный бизнес-UI закрывает задачу.

02

Runtime + свои приложения

Бэк-офис работает в Runtime, а клиенты и мобильные сотрудники — в специализированных интерфейсах.

03

Только свой frontend

Полностью собственный сайт или приложение работает с CosmoApps через Data API. Runtime можно не использовать вовсе.

Базовые операции Data API

POST /services/cosmoData.ashx Headers: X-Cosmo-App-Id: <application id> X-Cosmo-Api-Key: <limited application key> Operations: select - выборка с фильтрами и постраничным выводом byKey - загрузка документа по id upsert - создание или обновление документа delete - удаление документа

API — не только CRUD

Поверх документных данных работает семантический язык запросов. Он позволяет обращаться к типам модели и строить связи, не заставляя клиентский код вручную собирать документы.

SELECT o.Number, c.Name FROM Order o LEFT JOIN Company c ON o.Client = c WHERE o.Status = @status ORDER BY o.Date DESC

Поддерживаются INNER JOIN, LEFT JOIN и JOIN по вложенным массивам. Конкретный синтаксис развивается вместе с query-слоем.

Безопасность: не размещайте мастер-ключи хранилища в браузере. Для клиентских приложений используйте ограниченные ключи Data API или серверный прокси — в зависимости от сценария.