Блог Горошко Андрея Bitrix24 Создать универсальный список lists.add

Создать универсальный список lists.add

goroshckogoroshcko| Нет комментария|
Рубрики:

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Создать универсальный список lists.add», проанализируем лучшие практики и покажем, как правильно использовать создать универсальный в реальных задачах.

Создать универсальный список lists.add

> Scope: lists
>
> Кто может выполнять метод: администратор

Метод lists.add создает универсальный список.

Параметры метода

Название
тип		Описание
IBLOCK_TYPE_ID
string		Идентификатор типа инфоблока. Возможные значения:
— lists — тип инфоблока списка
— bitrix_processes — тип инфоблока процессов
— lists_socnet — тип инфоблока списков групп
IBLOCK_CODE
string		Cимвольный код инфоблока
SOCNET_GROUP_ID
integer		Идентификатор группы. Используйте параметр, если хотите добавить список в группу.

Идентификатор можно получить с помощью методов socialnetwork.api.workgroup.list, sonet_group.get и sonet_group.user.groups

FIELDS
array		Массив полей списка.

Подробное описание

MESSAGES
array		Массив подписей к элементам и разделам списка. Поддерживаемые значения:

— ELEMENTS_NAME — название элементов
— ELEMENT_NAME — название элемента
— ELEMENT_ADD — добавить элемент
— ELEMENT_EDIT — изменить элемент
— ELEMENT_DELETE — удалить элемент
— SECTIONS_NAME — название разделов
— SECTION_NAME — название раздела
— SECTION_ADD — добавить раздел
— SECTION_EDIT — изменить раздел
— SECTION_DELETE — удалить раздел

RIGHTS
array		Настройка прав доступа к списку. Массив в формате ключ-значение, где ключ — это буквенный код пользователя или отдела с идентификатором, а значение — буквенный код права.

RIGHTS: {
    'U1': 'X', // Пользователю с ID=1 — полный доступ
    'D5': 'D'  // Сотрудникам отдела с ID=5 — запрет доступа
}

Категории пользователей:
— U — пользователь
— * — все пользователи
— D — все сотрудники отдела
— DR — все сотрудники отдела с подотделами

Получить идентификатор пользователя можно с помощью метода user.get, идентификатор отдела — методом department.get.

Виды прав:
— D — нет доступа
— R — чтение
— E — добавление
— S — просмотр в панели
— T — добавление в панели
— U — изменение с ограничениями
— W — изменение
— X — полный доступ

Если параметр не передан, авторизованному пользователю, который вызвал метод, назначается полный доступ

Параметр FIELDS {#parametr-fields}

Название
тип		Описание
NAME
string		Название списка
DESCRIPTION
string		Описание списка
SORT
integer		Сортировка
PICTURE
array		Картинка. Объект в формате {fileData: [value1, value2]}, где value1 — название файла картинки с расширением, value2 — картинка в формате base64
BIZPROC
string		Включение поддержки бизнес-процессов. Возможные значения:
— Y — да
— N — нет

Примеры кода

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_CODE":"my_custom_list","FIELDS":{"NAME":"Мой новый список","DESCRIPTION":"Список для отслеживания задач в проекте","SORT":500,"BIZPROC":"Y"},"MESSAGES":{"ELEMENTS_NAME":"Задачи","ELEMENT_NAME":"Задача","ELEMENT_ADD":"Добавить задачу","ELEMENT_EDIT":"Изменить задачу","ELEMENT_DELETE":"Удалить задачу","SECTIONS_NAME":"Разделы","SECTION_NAME":"Раздел","SECTION_ADD":"Добавить раздел","SECTION_EDIT":"Изменить раздел","SECTION_DELETE":"Удалить раздел"},"RIGHTS":{"U1271":"X"}}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/lists.add
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_CODE":"my_custom_list","FIELDS":{"NAME":"Мой новый список","DESCRIPTION":"Список для отслеживания задач в проекте","SORT":500,"BIZPROC":"Y"},"MESSAGES":{"ELEMENTS_NAME":"Задачи","ELEMENT_NAME":"Задача","ELEMENT_ADD":"Добавить задачу","ELEMENT_EDIT":"Изменить задачу","ELEMENT_DELETE":"Удалить задачу","SECTIONS_NAME":"Разделы","SECTION_NAME":"Раздел","SECTION_ADD":"Добавить раздел","SECTION_EDIT":"Изменить раздел","SECTION_DELETE":"Удалить раздел"},"RIGHTS":{"U1271":"X"},"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/lists.add
  • JS
    try {
        const response = await $b24.callMethod(
          'lists.add',
          {
              IBLOCK_TYPE_ID: 'lists',
              IBLOCK_CODE: 'my_custom_list',
              FIELDS: {
                NAME: 'Мой новый список',
                DESCRIPTION: 'Список для отслеживания задач в проекте',
                SORT: 500,
                BIZPROC: 'Y'
              },
              MESSAGES: {
                ELEMENTS_NAME: 'Задачи',
                ELEMENT_NAME: 'Задача',
                ELEMENT_ADD: 'Добавить задачу',
                ELEMENT_EDIT: 'Изменить задачу',
                ELEMENT_DELETE: 'Удалить задачу',
                SECTIONS_NAME: 'Разделы',
                SECTION_NAME: 'Раздел',
                SECTION_ADD: 'Добавить раздел',
                SECTION_EDIT: 'Изменить раздел',
                SECTION_DELETE: 'Удалить раздел'
              },
              RIGHTS: {
                'U1271': 'X'
              }
          }
      );

        const result = response.getData().result;
        console.log('Created list with ID:', result);
        processResult(result);
    } catch (error) {
        console.error('Error:', error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'lists.add',
                [
                    'IBLOCK_TYPE_ID' => 'lists',
                    'IBLOCK_CODE' => 'my_custom_list',
                    'FIELDS' => [
                        'NAME' => 'Мой новый список',
                        'DESCRIPTION' => 'Список для отслеживания задач в проекте',
                        'SORT' => 500,
                        'BIZPROC' => 'Y'
                    ],
                    'MESSAGES' => [
                        'ELEMENTS_NAME' => 'Задачи',
                        'ELEMENT_NAME' => 'Задача',
                        'ELEMENT_ADD' => 'Добавить задачу',
                        'ELEMENT_EDIT' => 'Изменить задачу',
                        'ELEMENT_DELETE' => 'Удалить задачу',
                        'SECTIONS_NAME' => 'Разделы',
                        'SECTION_NAME' => 'Раздел',
                        'SECTION_ADD' => 'Добавить раздел',
                        'SECTION_EDIT' => 'Изменить раздел',
                        'SECTION_DELETE' => 'Удалить раздел'
                    ],
                    'RIGHTS' => [
                        'U1271' => 'X'
                    ]
                ]
            );

        $result = $response
            ->getResponseData()
            ->getResult();

        echo 'Success: ' . print_r($result, true);
        processData($result);

    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error adding list: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
      'lists.add',
      {
         IBLOCK_TYPE_ID: 'lists',
         IBLOCK_CODE: 'my_custom_list',
         FIELDS: {
           NAME: 'Мой новый список',
           DESCRIPTION: 'Список для отслеживания задач в проекте',
           SORT: 500,
           BIZPROC: 'Y'
         },
         MESSAGES: {
           ELEMENTS_NAME: 'Задачи',
           ELEMENT_NAME: 'Задача',
           ELEMENT_ADD: 'Добавить задачу',
           ELEMENT_EDIT: 'Изменить задачу',
           ELEMENT_DELETE: 'Удалить задачу',
           SECTIONS_NAME: 'Разделы',
           SECTION_NAME: 'Раздел',
           SECTION_ADD: 'Добавить раздел',
           SECTION_EDIT: 'Изменить раздел',
           SECTION_DELETE: 'Удалить раздел'
         },
         RIGHTS: {
           'U1271': 'X',     // пользователь с ID=1271 — полный доступ
         }
       },
         function(result) {
            if (result.error()) {
               console.error(result.error());
            } else {
               console.log(result.data());
         }
       }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'lists.add',
        [
            'IBLOCK_TYPE_ID' => 'lists',
            'IBLOCK_CODE' => 'my_custom_list',
            'FIELDS' => [
                'NAME' => 'Мой новый список',
                'DESCRIPTION' => 'Список для отслеживания задач в проекте',
                'SORT' => 500,
                'BIZPROC' => 'Y'
            ],
            'MESSAGES' => [
                'ELEMENTS_NAME' => 'Задачи',
                'ELEMENT_NAME' => 'Задача',
                'ELEMENT_ADD' => 'Добавить задачу',
                'ELEMENT_EDIT' => 'Изменить задачу',
                'ELEMENT_DELETE' => 'Удалить задачу',
                'SECTIONS_NAME' => 'Разделы',
                'SECTION_NAME' => 'Раздел',
                'SECTION_ADD' => 'Добавить раздел',
                'SECTION_EDIT' => 'Изменить раздел',
                'SECTION_DELETE' => 'Удалить раздел'
            ],
            'RIGHTS' => [
                'U1271' => 'X'
            ]
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';

Обработка ответа

HTTP-статус: 200

{
    "result": 109,
    "time": {
       "start": 1764675143,
       "finish": 1764675143.174578,
       "duration": 0.17457795143127441,
       "processing": 0,
       "date_start": "2025-12-02T14:32:23+03:00",
       "date_finish": "2025-12-02T14:32:23+03:00",
       "operating_reset_at": 1764675743,
       "operating": 0
    }
}

Возвращаемые данные

Название
тип		Описание
result
integer		Идентификатор созданного инфоблока
time
time		Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":"ERROR_IBLOCK_ALREADY_EXISTS",
    "error_description":"Iblock already exists"
}

Возможные коды ошибок

КодОписаниеЗначение
ERROR_REQUIRED_PARAMETERS_MISSINGRequired parameter X is missingОбязательный параметр не передан
ERROR_IBLOCK_ALREADY_EXISTSIblock already existsСписок с таким IBLOCK_CODE уже существует
ERROR_ADD_IBLOCK—Ошибка при добавлении списка
ACCESS_DENIEDAccess deniedМетод запустил не администратор
  • [](./lists-update)
  • [](./lists-get)
  • [](./lists-delete)
  • [](./lists-get-iblock-type-id)

💡 Экспертное мнение и рекомендации

Советы эксперта по интеграции:

  • Всегда используйте кэширование при частых запросах к создать универсальный, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «Создать универсальный список lists.add».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Входящие и исходящие вебхукиВходящие и исходящие вебхуки

25.05.202625.05.2026| goroshckogoroshcko| Нет комментария|

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Входящие и исходящие вебхуки», проанализируем лучшие практики и

Читать далееЧитать далее

Изменить задачу tasks.task.updateИзменить задачу tasks.task.update

25.05.202625.05.2026| goroshckogoroshcko| Нет комментария|

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Изменить задачу tasks.task.update». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции. Изменить задачу

Читать далееЧитать далее

Добавить привязку заказа к объекту CRM crm.orderentity.addДобавить привязку заказа к объекту CRM crm.orderentity.add

25.05.202625.05.2026| goroshckogoroshcko| Нет комментария|

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Добавить привязку заказа к объекту CRM crm.orderentity.add». Мы подготовили подробный разбор принципов работы и развернутые

Читать далееЧитать далее