| модуль превращает сайт на Битриксе в API-платформу - любая ORM-сущность или контроллер ядра становится JSON-методом, а MCP-сервер, методы и веб-хуки управляются из админ-панели без кода. | ||
|---|---|---|
| Всё живёт на сайте - без внешнего сервиса и абонентской платы. |
![]() MCP-сервер для ИИ Протокол JSON-RPC 2.0: initialize, tools/list, tools/call, ресурсы и промпты. | ![]() API с любой ORM-сущности list, add, update, delete, get, fields и групповые действия для любой таблицы. | |
|---|---|---|
![]() Вебхуки неограниченно и выбором набора методов под каждый хук. | ![]() API в любой контроллер выбор доступных action в контроллере. |

формат вызова различается только назначением.

![]() Метод по хуку awz:bxorm.api.app.call&app=ID&method=КОД.МЕТОДпрямой вызов метода; токен хука передаётся в URL или в заголовке Authorization. | ![]() ORM-параметры awz:bxorm.api.hook.callте же вызовы с параметрами order, select, filter, start, id, fields. | ![]() MCP-сервер awz:bxorm.api.bxmcp.callrpc&app=ID&mcprpc=2.0транспорт JSON-RPC 2.0 для ИИ-клиентов. |
|---|
| Одна кнопка в настройках модуля - и сайт готов к подключению ИИ-клиента по протоколу MCP: сервер живёт на самом сайте - без внешнего сервиса и абонентской платы. С модулем awz.admin можно настраивать разные функции для разных агентов - количество разных MCP не ограничено. |
|---|

initialize, ping, tools/list, tools/call, resources/list, resources/read, prompts/list, prompts/get -
ping и полный транспорт JSON-RPC 2.0.
dbinfo | Тип и версия СУБД, хост, имя базы данных. | |
| envinfo | Информация об окружении сайта. | |
| phpinfo | Версия PHP, загруженные расширения, memory_limit, max_execution_time. | |
| cmsinfo | Версия CMS, редакция, список установленных модулей. | |
| processinfo | Нагрузка сервера: top, free, nproc; при недоступном shell - load average, ядра и память. | |
| log_set | Включает и настраивает лог: файл, размер до ротации (1-512 МБ), уровень, тип, доп. параметры. | |
| log_get | Последние N строк лог-файла Битрикса: стандартный лог или файл PSR-логгера. | |
| log_clear | Усекает (ротирует) лог-файл; настройки логирования сохраняются. | |
| log_off | Полностью отключает системное логирование и debug. | |
| file_get | Чтение файла целиком или выбранных строк («10», «10-25», «1,5,9-12»); белый список каталогов, служебные файлы запрещены. | |
| iblocks | Список инфоблоков: ID, название, код, тип, активность, количество элементов; поиск по названию и типу. | |
| sections | Активные разделы инфоблока деревом: ID, NAME, CODE, SECTION_PAGE_URL, DEPTH_LEVEL. | |
| reindexitem | Обновляет поисковый индекс и фасетный индекс элемента инфоблока и пересчитывает наследуемые мета-значения. Вызывай после изменения элемента/свойств, чтобы изменения появились в поиске и умном фильтре. В параметрах только id элемента - ID инфоблока определяется автоматически. | |
| updateitemprop | Обновляет значение свойства элемента инфоблока по коду свойства. Параметры: id элемента, code - код свойства, value - новое значение. После изменения вызывай reindexitem для обновления индексов. | |
| getitem | Возвращает данные элемента инфоблока: все поля + непустые свойства (CODE, NAME, TYPE - тип свойства, VALUE). Поиск по id элемента или по фильтру (JSON-строка, например {"CODE":"my-code"}). limit - количество элементов в ответе (по умолчанию 1, максимум 100; >1 - ответ массив). | |
| updateseoitem | Устанавливает мета-теги элемента инфоблока: page_title (H1 страницы), seo_title (title), seo_descr (description). Пустые параметры не перезаписывают текущие значения. | |
| deletemetaitem | Очищает мета-теги элемента инфоблока (H1, title, description) - сбрасывает индивидуальные шаблоны и кеш наследуемых значений. | |
| additem | Добавляет элемент инфоблока. Параметры: iblock_id (обязателен), name (название, обязателен), description (детальное описание, html определяется автоматически), section_id (ID раздела), preview_picture / detail_picture (путь или URL картинки), active (Y по умолчанию / N), fields - доп. поля JSON-строкой (в т.ч. PROPERTY_КОД для свойств, PREVIEW_TEXT, CODE и др.). Символьный код (CODE) если не передан - генерируется автоматически, уникальный в пределах инфоблока. После изменения вызывай reindexitem. | |
| updateitemfields | Изменяет элемент инфоблока. Параметры: id (обязателен), name, description, section_id, preview_picture / detail_picture (путь или URL; "false"/"del" - удалить файл), active (меняется только при явной передаче Y/N), fields - доп. поля JSON-строкой (в т.ч. PROPERTY_КОД). Пустые параметры не перезаписывают текущие значения. После изменения вызывай reindexitem. | |
| updateseosect | Устанавливает мета-теги раздела инфоблока: page_title (H1 страницы), seo_title (title), seo_descr (description). Пустые параметры не перезаписывают текущие значения. | |
| deletemetasection | Очищает мета-теги раздела инфоблока (H1, title, description) - сбрасывает индивидуальные шаблоны и кеш наследуемых значений. | |
| loadphoto | Постоянное изображение из base64 в /upload/awz.load.ai/ и публичный URL; png, jpg, jpeg, webp, svg, gif. | |
| tmpphoto | Временное изображение из base64 в /upload/awz.gen.tmp/ для превью; файлы старше часа удаляются автоматически. |
Событие для добавления собственных инструментов MCP без правки кода модуля.
| Класс контроллера ядра (например Basket): методы ядра - getfields, get, getcurrency и другие; доступные action выбираются в настройках метода. | ||
|---|---|---|
| API контроллеров ядра может быть нестабильным: модуль рекомендует собственные контроллеры Awz\BxOrm\ApiScopes\Controller. | ||
| API работает и без ИИ: обычный REST по /bitrix/services/main/ajax.php для мобильных приложений и интеграций. |

методы list, add, update, delete, get, fields и групповые действия.
типы IntegerField, StringField и другие; primary, read-only, required, sortable.
Метод выключается флажком без удаления настройки.

Расширение под проект
Событие onBeforeHookCallAction позволяет изменить логику обработки action в контроллере - до обращения к сущности.
Что можно сделать:
- изменить данные события в объекте Awz\\BxOrm\\Api\\BinderResult - идентификатор, поля, фильтры;
- добавить свою ошибку валидации в BinderResult - вызов не дойдёт до сущности;
- вернуть свои данные вместо обращения к базе - заглушки и мок-ответы для интеграций.
Пример обработчика:
// event handler: /bitrix/php_interface/init.php
$eventManager->addEventHandler(\\'awz.bxorm\\', \\'onBeforeHookCallAction\\',
function(\\Bitrix\\Main\\Event $event) {
/** @var \\Awz\\BxOrm\\Api\\BinderResult $binder **/
$binder = $event->getParameter(\\'binder\\');
// подмена данных вместо обращения к базе
if ($binder->getMethod() === \\'list\\') {
$binder->setResult([\\'items\\' => [], \\'total\\' => 0]);
}
}
); |
Модуль не трогает ядро: методы и хуки живут в своих таблицах, API включается и выключается флажками.
Установили модуль, создали метод, добавили веб-хук - сайт готов отвечать по API и работать с ИИ-клиентом.
Для работы административных страниц необходим установленный модуль AWZ: Конструктор списков:
- Маркетплейс - https://marketplace.1c-bitrix.ru/solutions/awz.admin/
- GitHub - https://github.com/azahalski/awz.admin
Установка
- Установите модуль через систему обновлений
- Добавьте методы для API: Настройки - AWZ: Api на вебхуках - Методы API.
Доступны контроллеры и ORM-сущности - наследники Bitrix\Main\Engine\Controller, Awz\BxOrm\Api\Scopes\Controller, Bitrix\Main\ORM\Data\DataManager - Настройте методы API
- Добавьте веб-хук и отметьте доступные методы
- В списке веб-хуков будут доступны ссылки на методы API
Подключение MCP-сервера для ИИ
MCP-приложение создается одной кнопкой «Создать MCP» в настройках модуля: метод и веб-хук с токеном формируются автоматически, URL и ключ готовы к передаче. Повторное нажатие обновляет приложение.
Быстрый старт:
- Нажмите «Создать MCP» в настройках модуля
- Скопируйте URL и токен из созданного приложения
- Передайте их своему ИИ-агенту (Claude или другой MCP-клиент) в промпте, например:
Подключись к MCP-серверу по URL: https://мой_сайт.ру/bitrix/services/main/ajax.php?...awz:bxorm.api.bxmcp.callrpc&app=<ид_приложения> Используй токен: <токен_хука> |
Router (по желанию)
Для доступа по url вида:
мой_сайт.ру/api/hook/<ид_хука>/<токен_хука>/<метод> |
настройте router по документации.
Открытая линия поддержки - https://zahalski.bitrix24.by/online/opensource
Telegram: @andrew_zahalski
Email: info<гав>zahalski<точка>dev
Для покупки товара в нашем интернет-магазине выберите понравившийся товар и добавьте его в корзину. Далее перейдите в Корзину и нажмите на «Оформить заказ» или «Быстрый заказ».
Если оформляете быстрый заказ: напишите ФИО, телефон и e-mail. Вам перезвонит менеджер и уточнит условия заказа. По результатам разговора вам придет подтверждение оформления товара на почту или через СМС. Теперь останется только ждать доставки и радоваться новой покупке.
Оформление заказа в стандартном режиме выглядит следующим образом. Заполняете полностью форму по последовательным этапам: адрес, способ доставки, оплаты, данные о себе. Советуем в комментарии к заказу написать информацию, которая поможет курьеру вас найти. Нажмите кнопку «Оформить заказ».
Оплачивайте покупки удобным способом. В интернет-магазине доступно 3 варианта оплаты:
- Наличные при самовывозе или доставке курьером. Специалист свяжется с вами в день доставки, чтобы уточнить время и заранее подготовить сдачу с любой купюры. Вы подписываете товаросопроводительные документы, вносите денежные средства, получаете товар и чек.
- Безналичный расчет при самовывозе или оформлении в интернет-магазине: карты МИР. Чтобы оплатить покупку на сайте, система перенаправит вас на сервер платежной системы. Здесь нужно ввести номер карты, срок действия и имя держателя.
- Электронные системы при онлайн-заказе: ЮMoney. Для совершения покупки система перенаправит вас на страницу платежного сервиса. Здесь необходимо заполнить форму по инструкции.
- Безналичная оплата на наш расчетный счет по выставленному счету.
Экономьте время на получении заказа. В интернет-магазине доступно 4 варианта доставки:
- Электронная поставка - все необходимые сведения о лицензии, праве пользования, кодах, ключах и др. высылаются покупателю на его e-mail.
- Курьерская доставка. Когда товар будет отправлен с нашего склада, Вам придет уведомление. В день доставки с Вами заблаговременно свяжется курьер для уточнения времени и деталей доставки. Доставка производится "до двери". Осмотрите упаковку на целостность и соответствие указанной комплектации.
- Постамат. Когда заказ поступит на точку, на Ваш телефон или e-mail придет уникальный код. Заказ нужно оплатить в терминале постамата. Срок хранения — 3 дня.
- Доставка Почтой России. Когда заказ придет в отделение, на Ваш адрес придет извещение о посылке. Перед оплатой Вы можете оценить состояние коробки: вес, целостность. Вскрывать коробку самостоятельно Вы можете только после оплаты заказа. Один заказ может содержать не больше 10 позиций и его стоимость не должна превышать 100 000 р.
Дополнительная информация.
Изучите полный алгоритм продления лицензий на модули 1С-Битрикс: Маркетплейс, включая активацию льготных купонов. Мы детально разбираем все условия: обязательный 30-дневный срок для сохранения максимальной выгоды, пропорциональное ценообразование (12,5%, 25%, 50% от цены модуля) и ограничение по минимальной сумме в 500 рублей. Этот гайд поможет вам эффективно планировать бюджет и гарантировать актуальность вашего проекта.





