Headless Bitrix: свой JSON API на ядре D7 для SPA и мобильного приложения
Соберите API, который не стыдно отдать фронтендеру и мобильному разработчику: роутинг и тонкие контроллеры, единый контракт ответа, сессия для браузера и Bearer для телефона, CORS, кэш, realtime и OpenAPI. На штатном ядре, без api.php в корне и без правок /bitrix/.
24 900 ₽
Набор в этот поток закрыт
Поток уже идёт, присоединиться к нему поздно. Группа на следующий поток уже собирается. Запишитесь — и как только определим даты, пришлём уведомление на почту. Платить пока ничего не нужно.
Запись на следующий поток бесплатна: напишем на почту, когда определим даты.
Ведущий
Техлид, архитектор и автор BXMax
Техлид, архитектор и автор BXMax
Техлид и архитектор сложных проектов на Битриксе: highload-каталоги, интеграции, DevOps-пайплайны
и код-ревью команд. Создатель BXMax, Omut и открытого пака bitrix-framework-skills.
Слово «headless» в ТЗ обычно заканчивается файлом api.php в корне сайта: первый JSON готов за час,
а через полгода никто не помнит, где проверяются права и почему ошибка приходит с кодом 200.
На воркшопе мы соберём API, в котором на эти вопросы отвечает архитектура, а не память команды.
Инструменты
Чему вы научитесь
Свой /api/v1 на штатном ядре
Маршруты в /local/routes, тонкие контроллеры, сервисы и репозитории с DI, единый конверт ответа и каталог кодов ошибок, на который фронт может опереться.
Чтение и запись, которым не страшен чужой ввод
ORM инфоблоков и HL-блоков, белые списки сортировки и фильтров, валидация Request DTO, честные HTTP-статусы, загрузка файлов и выборка без N+1.
Браузер, телефон и интеграторы на одних действиях
Сессия с CSRF для SPA, отзываемые Bearer-токены для мобилки, защита от IDOR, CORS по белому списку и вторая поверхность через модуль rest и REST v3.
От работающего кода к сдаче заказчику
Кэш с самосбросом по событиям данных, фоновые задачи, Pull-сигналы, OpenAPI, который сверяется с кодом, тесты контракта и лимит запросов на логин.
Кому подойдёт
Для кого и что нужно заранее
Для кого
- Bitrix-разработчики, которые писали компоненты и ajax.php, но не собирали API для внешнего фронта
- Fullstack- и фронтенд-лиды, которым нужен предсказуемый JSON-контракт от Битрикса
- Техлиды, которым нужен эталонный API-модуль для код-ревью и онбординга команды
Требования
- PHP 8.2+ на уровне ООП, базовые инфоблоки и опыт работы с /local/
- Omut или локальный Битрикс с main 25.900+ для домашних заданий
- curl или Postman: проверять API будем из терминала и коллекции запросов
Программа
Программа занятий
-
Модуль 1 9 ноября, 20:00
Каркас API магазина на роутинге Битрикса
Разберём, когда витрине нужен свой API, а когда для интеграции подходит модуль rest. В модуле bxmax.shop настроим два маршрута. Через /api/v1/health проверим работу API, через /api/v1/products получим список товаров. Проведём запрос от контроллера через сервис к репозиторию-заглушке и зафиксируем формат JSON-ответа для фронтенда. В домашке заполним список товарами из массива и добавим категории.
-
Модуль 2 11 ноября, 20:00
Каталог товаров, цены и первые тесты на Pest
Напишем на Pest тест сервиса каталога с репозиторием в памяти. Затем подключим инфоблок «Одежда» через ORM и получим товары с базовыми ценами. Соберём список для витрины и карточку с артикулом и описанием. Проверим, что при запросе отсутствующего товара API вернёт HTTP 404 и код PRODUCT_NOT_FOUND. В домашке загрузим категории из разделов инфоблока и откроем карточку категории по символьному коду.
-
Модуль 3 16 ноября, 20:00
Корзина гостя и проверка запросов
Прочитаем корзину гостя через модуль sale, добавим торговое предложение с известным ID, изменим количество и удалим позицию. Витрина передаёт ID и количество в JSON, цену определяет Битрикс. Опишем поля и правила проверки в Request DTO и разберём, как CSRF-токен связывает запрос с сессией браузера. В домашке добавим очистку всей корзины и проверим, что повторная очистка тоже проходит успешно.
-
Модуль 4 18 ноября, 20:00
Каталог без N+1 и выбор торгового предложения
Научим витрину получать размеры и цвета через ?include=offers и добавлять в корзину выбранное предложение. Сравним число SQL-запросов на страницах из 2 и 20 товаров до и после пакетной загрузки. Добавим фотографии с абсолютными URL, пагинацию через PageNavigation и сортировку по разрешённым полям. На отдельном примере проверим содержимое загружаемого изображения.
-
Модуль 5 23 ноября, 20:00
Покупатель и его корзина после входа
Добавим товар в корзину гостем, войдём в аккаунт и проверим, какие позиции увидит покупатель. Для браузерной витрины используем сессию и CSRF, для мобильного клиента выдадим и отзовём Bearer-токен. Настроим CORS для витрины на другом домене. На двух аккаунтах проверим, что каждый покупатель видит только свою корзину.
-
Модуль 6 25 ноября, 20:00
Оформление заказа с доставкой и оплатой
Оформим заказ из корзины покупателя. Заполним контакты и обязательные свойства, выберем доступные способы доставки и оплаты, пересчитаем итоговую сумму на сервере. Сохраним заказ через модуль sale и откроем его в админке Битрикса. Сверим номер, сумму, отгрузку и оплату. Повторим запрос с тем же ключом идемпотентности и убедимся, что заказ остался один. Проверим доступ к заказу из двух аккаунтов и покажем его выгрузку через REST v3.
-
Модуль 7 30 ноября, 20:00
Статус заказа на витрине и кеш каталога
Изменим статус оформленного заказа в админке. По сигналу Pull витрина запросит заказ ещё раз и покажет покупателю новый статус без перезагрузки страницы. Разберём, какую работу можно выполнить в фоне после ответа API. Для каталога настроим тегированный кеш и проверим, что после изменения товара витрина получает свежие данные.
-
Модуль 8 2 декабря, 20:00
Проверка магазина перед выпуском и разбор дипломов
Напишем HTTP-тест, который проходит весь путь покупателя от каталога до оформленного заказа. Сверим реальные ответы и ошибки со спецификацией OpenAPI, проверим ограничение числа попыток входа. Запишем миграции и порядок выкладки в PRODUCTION.md. На разборе дипломов посмотрим, как участники реализовали API категорий в своих магазинах.
Запись
Что включено
- 8 живых занятий по 2 часа, по понедельникам и средам
- Записи всех занятий — остаются у вас навсегда
- Готовый код к каждому занятию: снапшоты модуля от первого endpoint до итогового API
- Код-ревью домашних заданий лично от автора
- Доступ в закрытый чат выпускников
- Omut Pro на год — среда разработки, в которой мы работаем на занятиях
Подписчики BXMax платят меньше: −10% на уровне «Клуб BXMax», −20% на уровне «Максимум».
Можно записаться и оплатить позже, но место закрепляется только оплатой. Крайний срок оплаты — 9 ноября 2026.
Набор в этот поток закрыт
Поток уже идёт, присоединиться к нему поздно. Группа на следующий поток уже собирается. Запишитесь — и как только определим даты, пришлём уведомление на почту. Платить пока ничего не нужно.
Запись на следующий поток бесплатна: напишем на почту, когда определим даты.