Интеграции и модульная платформа
Раздел для разработчиков и интеграторов: CRM, ERP, уведомления и собственные сервисы через модульную систему интеграций (Integration Platform).
Отдельно от API: 1С и API: B2B.
Три способа связать системы
| Способ | Когда | Код в modules/Integrations/ |
|---|---|---|
| A. Исходящий webhook | Внешний HTTPS‑сервер | Не обязателен |
| B. PHP‑модуль | Логика в репозитории клиента | hooks.php + handlers |
| C. REST API | Pull: чтение и смена статусов | Ключ Настройка API |
A и B — push (очередь после действия на сайте). C — pull.
Сущности и панель
Группа меню Модули интеграций (не «Система»):
| Сущность | Пункт меню | Назначение |
|---|---|---|
| Пакет (модуль) | Каталог модулей | manifest, версия, включение, действия модуля |
| Подключение (инстанс) | Подключения модулей | Точка / все точки, креды, форма модуля (instance_form) |
| Доставка хуков | Очередь хуков модулей | pending … failed |
| Лицензия | Лицензирование модулей | Ключ, если license.required |
| Служебная интеграция | Интеграции | Записи external_system для legacy-контура и совместимости; новые manifest-модули обычно не настраивают здесь вручную |
| API‑ключ | Система → Настройка API | Bearer для REST |
Подробнее про подключения и bulk: Подключения модулей.
Схема доставки
code
Действие на сайте
│
▼
Snapshot + идемпотентность
│
├─► integrations.outbound → POST на ваш URL
│
└─► integrations.{Code} → Handler::handle()
Ответ покупателю — до выполнения интеграций. Без воркера задачи копятся в Очередь хуков, сайт работает.
Навигация
Старт
Разработка
- Разработка пакета
- Подключения модулей —
instance_form, bulk,external_system - Manifest
- Хуки
- Лицензирование
Обмен
Эксплуатация
URL и env
Префикс: /api/integrations/v1/.
env
INTEGRATIONS_DEBUG=true
INTEGRATIONS_LOG_LEVEL=debug
Лог: storage/logs/integrations.log.