Документация

Консоль Аналитика с ИИ: интеграция внешней обработки

Практическое руководство для 1С‑интегратора: какие endpoint использовать, в какой последовательности работать с дашбордами и виджетами, как запускать сессию редактирования и как реализовать рендер в 1С.

База API и авторизация

Все REST endpoint консоли аналитики доступны по префиксу:

/api/manager-1c/

Авторизация — Bearer токен из личного кабинета.

Authorization: Bearer <TOKEN>
Content-Type: application/json

Рекомендуемый сценарий работы 1С

  1. 1.Получить список конфигураций и выбрать текущую `configuration_ref`.
  2. 2.Получить список дашбордов для выбранной конфигурации.
  3. 3.Создать дашборд или выбрать существующий.
  4. 4.Создать сессию аналитической консоли в контексте выбранного дашборда.
  5. 5.Работать с виджетами (создание/изменение/удаление) и сообщениями сессии.
  6. 6.Собрать словарь данных по виджетам в 1С и отрендерить HTML локально (встроенный браузер 1С).

Основные endpoint

Конфигурации
GET /api/manager-1c/configs/
GET /api/manager-1c/configs/templates/
Дашборды
GET    /api/manager-1c/analytics-console/dashboards/?configuration_ref=<UUID>
POST   /api/manager-1c/analytics-console/dashboards/
PATCH  /api/manager-1c/analytics-console/dashboards/<id>/?configuration_ref=<UUID>
DELETE /api/manager-1c/analytics-console/dashboards/<id>/?configuration_ref=<UUID>
// POST body
{
  "configuration_ref": "8f7c2b2d-....",
  "title": "Продажи по отделам",
  "description": "Оперативная панель",
  "is_active": true
}
Виджеты дашборда
GET    /api/manager-1c/analytics-console/dashboard-elements/?configuration_ref=<UUID>
POST   /api/manager-1c/analytics-console/dashboard-elements/
PATCH  /api/manager-1c/analytics-console/dashboard-elements/<id>/?configuration_ref=<UUID>
DELETE /api/manager-1c/analytics-console/dashboard-elements/<id>/?configuration_ref=<UUID>
// POST body
{
  "dashboard": 15,
  "title": "Выручка по месяцам",
  "widget_type": 2,
  "display_order": 30,
  "onec_code": "..."
}

`widget_type` — это ID записи в справочнике типов виджетов.

Сессии аналитической консоли
GET  /api/manager-1c/analytics-console/sessions/?configuration_ref=<UUID>&dashboard_id=<id>
POST /api/manager-1c/analytics-console/sessions/
// POST body (обязательно dashboard_id)
{
  "dashboard_id": 15
}
Сообщения и виджеты в рамках сессии
GET  /api/manager-1c/analytics-console/sessions/<uuid>/entries/
POST /api/manager-1c/analytics-console/sessions/<uuid>/entries/
POST /api/manager-1c/analytics-console/sessions/<uuid>/clear/
GET  /api/manager-1c/analytics-console/sessions/<uuid>/widgets/
// POST entries body
{
  "text": "Добавь столбчатый график продаж по отделам за 6 месяцев"
}

Как реализовать рендер в 1С (логика)

Dashboard preview в ЛК используется только для тестов команды. В 1С нужно реализовать тот же подход локально: получить метаданные виджетов, вычислить данные и подставить их в шаблоны.

// Псевдо-JS (упрощенно)
const dashboard = await api.get('/analytics-console/dashboards/?configuration_ref=...');
const session = await api.post('/analytics-console/sessions/', { dashboard_id: dashboard.id });
const widgets = await api.get(`/analytics-console/sessions/${session.uuid}/widgets/`);

// В 1С выполняете код каждого виджета и собираете итог:
// widgetsDataMap[widget.id] = { data: результатВыполненияКода1С };
const widgetsDataMap = {};

for (const widget of widgets) {
  widgetsDataMap[widget.id] = {
    data: runOneCScript(widget.onec_code)
  };
}

// Дальше локальный рендер layout_template + widgetsDataMap
renderDashboard(widgets, widgetsDataMap);

Важно

  • Доступ к дашбордам ограничен парой: автор + конфигурация.
  • Для `list/retrieve/update/destroy` у дашбордов и элементов передавайте `configuration_ref` в query params.
  • Endpoint preview (`/lk/analyst-console/dashboard-preview/...`) предназначен для внутреннего тестирования UI, интегратору 1С не обязателен.
  • Если нужно сверить фактические поля API, используйте Redoc: /api/manager-1c/redoc/.