smarty-statisticДата актуальности: 2026-06-18. Read-only документация.
Справочник REST-эндпоинтов, экспонируемых роутамиsmarty-backend-stable/smarty-statistic/routes/.
Все маршруты подключены под префиксом /api/v2. Внутренний роутер монтируется как:
/api/v2/ws/:_wsId/statistic + basePath + path
| Класс запроса | Описание |
|---|---|
StatisticRequest (extends EmployeeRequest) |
Авторизованный сотрудник workspace. Дополнительно проверяет доступ к analytics-фиче и права доступа к объектам. |
Статистика строится по моделям CRM-объектов:
| Роутер | Модель данных | Описание |
|---|---|---|
routerContact |
Contact | Статистика по контактам |
routerProject |
Project | Статистика по проектам |
routerAssignment |
Assignment | Статистика по задачам |
routerRequisition |
Requisition | Статистика по заявкам |
routerExtChatBot |
ExtChatUser / ExtChatBot | Статистика по ботам |
Базовый путь: /api/v2/ws/:_wsId/statistic/contacts
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
POST |
/contacts/object-created/entries |
Employee | Записи: создание контактов | body: start, end, step, grouping[], allowed_only, фильтры (country, city, isImportant, isOrganization, employees[], _groupId[], marks[]) |
POST |
/contacts/object-archived/entries |
Employee | Записи: архивация контактов | аналогично |
POST |
/contacts/object-restored/entries |
Employee | Записи: восстановление контактов | аналогично |
POST |
/contacts/object-removed/entries |
Employee | Записи: удаление контактов | аналогично |
POST |
/contacts/object-stage/entries |
Employee | Записи: смена этапа | body: + stage[] |
| Метод | Путь | Auth | Назначение |
|---|---|---|---|
POST |
/contacts/object-created/objects |
Employee | Объекты: создание |
POST |
/contacts/object-archived/objects |
Employee | Объекты: архивация |
POST |
/contacts/object-restored/objects |
Employee | Объекты: восстановление |
POST |
/contacts/object-removed/objects |
Employee | Объекты: удаление |
POST |
/contacts/object-stage/objects |
Employee | Объекты: смена этапа |
| Метод | Путь | Auth | Назначение |
|---|---|---|---|
GET |
/contacts/group |
Employee | Группы, относящиеся к статистике |
GET |
/contacts/stage |
Employee | Этапы, относящиеся к статистике |
Базовый путь: /api/v2/ws/:_wsId/statistic/projects
Аналогично контактам, плюс:
| Метод | Путь | Auth | Назначение |
|---|---|---|---|
POST |
/projects/object-time/entries |
Employee | Записи: время по проектам |
POST |
/projects/object-time/objects |
Employee | Объекты: время по проектам |
Базовый путь: /api/v2/ws/:_wsId/statistic/assignments
Аналогично проектам, плюс:
| Метод | Путь | Auth | Назначение |
|---|---|---|---|
POST |
/assignments/linked-employee-changed/entries |
Employee | Записи: смена ответственного |
POST |
/assignments/linked-employee-changed/objects |
Employee | Объекты: смена ответственного |
POST |
/assignments/object-completed/entries |
Employee | Записи: завершение задачи |
POST |
/assignments/object-completed/objects |
Employee | Объекты: завершение задачи |
Базовый путь: /api/v2/ws/:_wsId/statistic/requisitions
Аналогично контактам (без object-time).
Базовый путь: /api/v2/ws/:_wsId/statistic/extbot
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
POST |
/extbot/ext-chat-bot-user-interacted/entries |
Employee | Записи: взаимодействие пользователей | body: start, end, messenger[], _botId[] |
POST |
/extbot/ext-chat-bot-user-subscribed/entries |
Employee | Записи: подписки | аналогично |
POST |
/extbot/ext-chat-bot-user-unsubscribed/entries |
Employee | Записи: отписки | аналогично |
POST |
/extbot/ext-chat-bot-user-total/entries |
Employee | Записи: общее количество | аналогично |
POST |
/extbot/ext-chat-bot-user-interacted/objects |
Employee | Объекты: взаимодействие | аналогично |
POST |
/extbot/ext-chat-bot-user-subscribed/objects |
Employee | Объекты: подписки | аналогично |
POST |
/extbot/ext-chat-bot-user-unsubscribed/objects |
Employee | Объекты: отписки | аналогично |
POST |
/extbot/ext-chat-bot-user-total/objects |
Employee | Объекты: общее количество | аналогично |
GET |
/extbot/list |
Employee | Боты, относящиеся к статистике | query: allowed_only |
Все POST-запросы /entries и /objects принимают:
| Параметр | Тип | Описание |
|---|---|---|
start |
Number | Начало периода (timestamp) |
end |
Number | Конец периода (timestamp) |
step |
Number | Группировка по дням (default: 1) |
grouping |
String[] | Группировка (enum зависит от типа статистики) |
allowed_only |
Boolean | Только по доступным объектам |
employees |
ObjectId[] | Фильтр по сотрудникам |
_groupId |
ObjectId[] | Фильтр по группам |
marks |
ObjectId[] | Фильтр по зонам ответственности |
country |
String[] | Фильтр по странам |
city |
String[] | Фильтр по городам |
no_country |
Boolean | Объекты без страны |
no_city |
Boolean | Объекты без города |
isImportant |
Boolean | Только ключевые объекты |