Консоль Аналитика с ИИ: интеграция внешней обработки
Практическое руководство для 1С‑интегратора: какие endpoint использовать, в какой последовательности работать с дашбордами и виджетами, как запускать сессию редактирования и как реализовать рендер в 1С.
База API и авторизация
Все REST endpoint консоли аналитики доступны по префиксу:
/api/manager-1c/
Авторизация — Bearer токен из личного кабинета.
Authorization: Bearer <TOKEN>
Content-Type: application/json
Рекомендуемый сценарий работы 1С
- 1.Получить список конфигураций и выбрать текущую `configuration_ref`.
- 2.Получить список дашбордов для выбранной конфигурации.
- 3.Создать дашборд или выбрать существующий.
- 4.Создать сессию аналитической консоли в контексте выбранного дашборда.
- 5.Работать с виджетами (создание/изменение/удаление) и сообщениями сессии.
- 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/.