метод REST scope: entity

entity.section.add

Добавить раздел хранилища

Кто может выполнять: пользователь с уровнем права W (запись) или X (управление) на хранилище данных

Описание

Метод entity.section.add добавляет раздел в хранилище данных приложения.

Метод работает только в контексте приложения.

Параметры

ENTITY string необязательный

Идентификатор хранилища данных приложения. Используйте значение, которое указали при создании хранилища.

Получить идентификатор можно методом entity.get

NAME string необязательный

Название раздела

SECTION integer необязательный

Идентификатор родительского раздела.

ACTIVE string необязательный

Флаг активности раздела:
- Y — раздел активен
- N — раздел неактивен

SORT integer необязательный

Индекс сортировки раздела

CODE string необязательный

Символьный код раздела

DESCRIPTION string необязательный

Описание раздела

PICTURE file необязательный

Картинка раздела. Формат файла — в статье Как загрузить файлы

DETAIL_PICTURE file необязательный

Детальная картинка раздела. Формат файла — в статье Как загрузить файлы

UF_ any необязательный

Пользовательские поля раздела UF_*.

Передаются отдельными параметрами в формате "UF_КОД": значение, например: "UF_COLOR": "#ff6600"

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ENTITY":"dish","NAME":"Тестовый раздел","SECTION":671,"ACTIVE":"Y","SORT":500,"CODE":"testovyy-razdel","DESCRIPTION":"Описание тестового раздела","PICTURE":["section.jpg","**base64_section_image**"],"DETAIL_PICTURE":["section-detail.jpg","**base64_section_detail_image**"],"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/entity.section.add

Ответ

HTTP-статус: 200

{
    "result": 673,
    "time": {
        "start": 1774275397,
        "finish": 1774275397.576672,
        "duration": 0.5766720771789551,
        "processing": 0,
        "date_start": "2026-03-23T17:16:37+03:00",
        "date_finish": "2026-03-23T17:16:37+03:00",
        "operating_reset_at": 1774275997,
        "operating": 0
    }
}

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

result integer

Идентификатор созданного раздела

time time

Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": "ERROR_ENTITY_NOT_FOUND",
    "error_description": "Entity not found"
}
Код Описание Значение
ERROR_ARGUMENT Argument 'ENTITY' is null or empty Параметр ENTITY не передан или пустой после очистки
ERROR_ARGUMENT Entity code is too long. Max length is N characters. Слишком длинное значение ENTITY
ERROR_ENTITY_NOT_FOUND Entity not found Хранилище с переданным ENTITY не найдено
ACCESS_DENIED Access denied! Недостаточно прав для создания раздела
ERROR_CORE Internal error adding entity section. Try adding again. Внутренняя ошибка при создании раздела
ERROR_CORE Неверный раздел-родитель! Передан невалидный SECTION
ERROR_CORE Код блока раздела не совпадает с кодом блока раздела-родителя! Родительский раздел принадлежит другому хранилищу
ERROR_CORE Неверный тип файла Передан файл неподдерживаемого типа в PICTURE или DETAIL_PICTURE

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.