Главная/Разработка/API
API 1С-Битрикс для разработчика: ядро D7, события и документация
API 1С-Битрикс для разработчика состоит из двух слоёв: старого ядра с классами вроде CIBlockElement и нового ядра D7, где данные описывают ORM-таблицы, а код работает через пространства имён Bitrix. Платформа поддерживает оба, поэтому в одном проекте встречается и тот, и другой код. Ниже: сравнение слоёв, рабочие примеры запроса и события, где хранить свой код и где лежит документация.
Ответ за 30 секунд
В проекте на Битриксе уживаются старое ядро и D7, и переписывать работающий код ради нового API не нужно. Новый код пишут на D7, а свои компоненты, шаблоны и обработчики хранят в папке local, чтобы обновления платформы их не затёрли.
Код проверяют на живой установке: тарифы Таймвеб для Битрикс от 596 ₽ в месяц, 10 дней на тест, память на процесс 2048 МБ и max_execution_time 1000 (на 21 октября 2026).
Какой API Битрикс выбрать под вашу задачу: подсказка для разработчика2слоя API: старое ядро и D7
/local/папка для своего кода
init.phpфайл для обработчиков событий
01 · 1 мин
Чем старое ядро Битрикс отличается от ядра D7 в коде#
Старое ядро состоит из классов с префиксом C: CIBlockElement, CUser, COption. Ядро D7 это новый слой в пространстве имён Bitrix, где данные описываются ORM-классами. В документации D7 сказано, что в перспективе старое API станет адаптером над новым ядром, но не вся функциональность пока продублирована, поэтому оба слоя живут рядом.
| Задача | Старое ядро | Ядро D7 |
|---|---|---|
| Подключить модуль | CModule::IncludeModule() | Loader::includeModule() |
| Прочитать элементы | CIBlockElement::GetList() | ElementTable::getList() |
| Подписаться на событие | AddEventHandler() | EventManager::getInstance()->addEventHandler() |
| Прочитать настройку | COption::GetOptionString() | Option::get() |
Документация советует не наследоваться от классов D7, а оборачивать их вызовы в свои методы: ядро развивается, и сигнатуры могут меняться.
02 · 1 мин
Как прочитать элементы инфоблока через ORM ядра D7#
Запрос к таблице элементов описывается массивом: поля, фильтр, сортировка, лимит. Ключ cache включает управляемый кэш на заданное число секунд.
<?php
use Bitrix\Main\Loader;
use Bitrix\Iblock\ElementTable;
if (!Loader::includeModule('iblock')) {
return;
}
$rows = ElementTable::getList([
'select' => ['ID', 'NAME', 'CODE'],
'filter' => ['=IBLOCK_ID' => 3, '=ACTIVE' => 'Y'],
'order' => ['SORT' => 'ASC'],
'limit' => 10,
'cache' => ['ttl' => 3600],
])->fetchAll();Число 3 в фильтре это номер инфоблока из админки. Инфоблоки хранят данные сайта: новости, каталог, справочники. Подключение модулей разобрано на странице модули 1С-Битрикс.
03 · 1 мин
Как подключить обработчик события в Битриксе и где хранить свой код#
События позволяют вмешаться в работу платформы, не меняя её файлы. Обработчик регистрируют один раз при каждом запросе, обычно в файле init.php.
<?php
// /local/php_interface/init.php
use Bitrix\Main\EventManager;
EventManager::getInstance()->addEventHandler(
'iblock',
'OnAfterIBlockElementAdd',
['MyHandlers', 'onElementAdd']
);
class MyHandlers
{
public static function onElementAdd(&$fields)
{
// $fields['ID'] holds the id of the new element
}
}Расположение файлов определяет, переживёт ли код обновление платформы:
- local/php_interface/init.php ядро подключает его на каждом запросе, здесь регистрируют обработчики;
- local/components/ собственные компоненты;
- local/templates/ шаблоны сайта и копии шаблонов компонентов;
- local/modules/ собственные модули.
Папка bitrix принадлежит платформе, её файлы заменяются при обновлении. Режим отладки включают в файле bitrix/.settings.php параметром debug в блоке exception_handling.
Инструмент · 1 мин
Какой API Битрикс выбрать под вашу задачу: подсказка для разработчика#
Выберите задачу и состояние кода. Подсказка назовёт подходящий инструмент.
Какой API Битрикс взять под задачу
Два вопроса, ответ сразу
05 · 1 мин
Где читать документацию по API Битрикс и чем REST Битрикс24 отличается от API сайта#
| Раздел | Адрес | Что внутри |
|---|---|---|
| Ядро D7 | dev.1c-bitrix.ru/api_d7 | пространство имён Bitrix и модули: Main, Iblock, Sale, Catalog |
| Старое API | dev.1c-bitrix.ru/api_help | классы и функции старого ядра |
| Учебные курсы | dev.1c-bitrix.ru/learning | курсы по компонентам, шаблонам и событиям |
| REST Битрикс24 | dev.1c-bitrix.ru/rest_help | методы REST для Битрикс24 |
Запросы про «битрикс rest api» чаще относятся к Битрикс24: там REST основной способ интеграции, с вебхуками и приложениями. Это другой продукт, он разобран в разделе Битрикс24.
На сайте с 1С-Битрикс: Управление сайтом откройте список модулей в админке. Если модуль REST установлен, методы доступны и на сайте. Если нет, данные внешним системам отдают через контроллеры D7 или готовый обмен с 1С:Предприятие. Общий порядок работ описан в обзоре разработка сайта на Битрикс.
06 · 1 мин
Вопросы об API Битрикс#
Что такое ядро D7 в 1С-Битрикс и нужно ли переписывать на него старый код?
D7 это новое ядро платформы с ORM и пространствами имён. Переписывать работающий код не нужно: поддерживаются оба ядра. Новые участки пишут на D7, где есть нужная функциональность.
Куда класть собственные компоненты и модули в проекте на 1С-Битрикс?
В папку local: компоненты в local/components, модули в local/modules, шаблоны в local/templates. Файлы в папке bitrix при обновлении заменяются.
Почему обработчик события Битрикс не срабатывает?
Частые причины: опечатка в имени модуля или события, регистрация в файле, который не подключается, и неверная сигнатура обработчика. Для событий инфоблока параметр передают по ссылке.
Работает ли REST API на сайте на 1С-Битрикс: Управление сайтом?
Это зависит от установленного модуля REST: проверьте список модулей в админке. REST Битрикс24 устроен отдельно и описан в его документации. Основные модули и их назначение: модули 1С-Битрикс.
Почему этому можно верить
Как мы проверяли
Источники цифр на этой странице: Хостинг для 1С-Битрикс Таймвеб, timeweb.com/ru/services/cms/bitrix, проверено 21 октября 2026; Цены на хостинг Таймвеб, timeweb.com/ru/services/hosting/price, проверено 21 октября 2026.
Разместите сайт на 1С-Битрикс
Битрикс требователен к ресурсам. Хостинг Таймвеб для 1С-Битрикс от 596 ₽ в месяц: NVMe, окружение под большие нагрузки, бесплатный SSL и домен .RU в подарок.
- Тарифы от 596 ₽ в месяц
- Оптимизирован под 1С-Битрикс
- Бесплатный SSL и ежедневные бэкапы
- Домен .RU в подарок при оплате за год