knowledgebase.section.add
Scope:
knowledgebaseКто может вызывать:
IblockRights::canAddSubsectionInSection()для родительского раздела. Подробнее: Права доступа
Создать раздел базы знаний
HTTP: POST
Побочные эффекты: создаёт раздел инфоблока базы знаний
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
name |
string |
да | Название раздела |
parentId |
int |
нет | ID родительского раздела; 0 или пропуск — корневой раздел (алиас: IBLOCK_SECTION_ID) |
Возвращаемые данные
Ответ в конверте модуля: result.result — созданный раздел (формат как у section.get); result.error.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
VALIDATION_ERROR |
Некорректные параметры или ошибка записи |
PERMISSION_DENIED |
Нет прав на создание подраздела в родительском разделе |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/knowledgebase.section.add.json" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '{
"name": "Новый раздел",
"parentId": 12
}'
Пример ответа
{
"result": {
"result": {
"id": 111,
"name": "REST Docs Temp Section",
"parentId": 96,
"left": 2,
"right": 3,
"depth": 2,
"count": 0
},
"error": null
}
}
См. также
Предыдущая
Следующая