smarty-integrationДата актуальности: 2026-06-18. Read-only документация.
Справочник REST-эндпоинтов, экспонируемых роутамиsmarty-backend-stable/smarty-integration/routes/.
Все маршруты подключены под префиксом /api/v2/integration. Полный путь:
/api/v2/integration + basePath роутера + path createRoute
| Класс запроса | Описание |
|---|---|
AuthRequest |
Авторизованная сессия (cookie/token). |
NoAuthRequest |
Без авторизации (webhook-хуки от Facebook). |
| Роутер | Файл | basePath | Описание |
|---|---|---|---|
hooks |
hooks.js |
/hooks |
Webhook-хуки сторонних сервисов |
pages |
pages.js |
/pages |
Управление интеграцией с соцсетями |
hooks.js)Базовый путь: /api/v2/integration/hooks
Описание: "Хуки сторонних сервисов"
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/hooks/facebook |
NoAuth | Верификация Facebook webhook | query: hub.mode, hub.verify_token, hub.challenge |
POST |
/hooks/facebook |
NoAuth | Обработка входящих событий Facebook | body: Facebook webhook payload |
Валидация GET: mode === 'subscribe' и token === '123123'.
Логика POST: извлекает rawExtId страницы из entry[0].id, находит SocialPage, вызывает handleHook.
pages.js)Базовый путь: /api/v2/integration/pages
Описание: "Управление интеграцией с социальными сетями"
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/pages/:social |
Auth | Список страниц соцсети (доступных и привязанных) | path: social (enum: facebook, vkontakte) |
POST |
/pages/:social |
Auth | Привязка страницы | path: social; body: pageId |
Ответ GET: рендерит шаблон pages_list (legacy SSR).
| Метод | Путь | Auth | Назначение |
|---|---|---|---|
GET |
/pages/:social/auth |
Auth | Перенаправление на OAuth-страницу для выдачи прав |
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
POST |
/pages/:social/:_id/sync |
Auth | Синхронизация токена, названия, аватарки | path: social, _id (ObjectId) |
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/pages/:social/:_id/bot |
Auth | Форма привязки бота к странице | path: social, _id |
POST |
/pages/:social/:_id/bot |
Auth | Создание бота для страницы | body: _wsId |
Ответ GET: рендерит шаблон bot_bind (показывает существующего бота или форму выбора workspace).
| Метод | Путь | Auth | Назначение | Параметры |
|---|---|---|---|---|
GET |
/pages/:social/:_id/lead |
Auth | Форма настройки импорта лидов | path: social, _id |
POST |
/pages/:social/:_id/lead |
Auth | Настройка импорта лидов | body: _wsId, _appId, _groupId |
Ответ GET: рендерит шаблон lead_bind (показывает существующую настройку или форму выбора workspace/API/группы).