Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Получить описание полей папки disk.folder.getfields». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.
Получить описание полей папки disk.folder.getfields
> Scope: disk
>
> Кто может выполнять метод: любой пользователь
Метод disk.folder.getfields возвращает описание полей папки.
Параметры метода
Без параметров.
Примеры кода
- cURL (Webhook)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/disk.folder.getfields- cURL (OAuth)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/disk.folder.getfields- JS
try
{
const response = await $b24.callMethod(
'disk.folder.getfields',
{}
);
const result = response.getData().result;
console.log('Data:', result);
processResult(result);
}
catch( error )
{
console.error('Error:', error);
}- PHP
try {
$response = $b24Service
->core
->call(
'disk.folder.getfields',
[]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
"disk.folder.getfields",
{},
function (result) {
if (result.error())
console.error(result.error());
else
console.dir(result.data());
}
);- PHP CRest
require_once('crest.php');
$result = CRest::call(
'disk.folder.getfields',
[]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Обработка ответа
HTTP-статус: 200
{
"result": {
"ID": {
"TYPE": "integer",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"NAME": {
"TYPE": "string",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"TYPE": {
"TYPE": "enum",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"CODE": {
"TYPE": "string",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"STORAGE_ID": {
"TYPE": "integer",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"REAL_OBJECT_ID": {
"TYPE": "integer",
"USE_IN_FILTER": false,
"USE_IN_SHOW": true
},
"PARENT_ID": {
"TYPE": "integer",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"CREATE_TIME": {
"TYPE": "datetime",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"UPDATE_TIME": {
"TYPE": "datetime",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"DELETE_TIME": {
"TYPE": "datetime",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
},
"CREATED_BY": {
"TYPE": "integer",
"USE_IN_FILTER": false,
"USE_IN_SHOW": true
},
"UPDATED_BY": {
"TYPE": "integer",
"USE_IN_FILTER": false,
"USE_IN_SHOW": true
},
"DELETED_BY": {
"TYPE": "integer",
"USE_IN_FILTER": false,
"USE_IN_SHOW": true
},
"DELETED_TYPE": {
"TYPE": "enum",
"USE_IN_FILTER": true,
"USE_IN_SHOW": true
}
},
"time": {
"start": 1768343226,
"finish": 1768343226.742822,
"duration": 0.7428219318389893,
"processing": 0,
"date_start": "2026-01-13T16:47:06+03:00",
"date_finish": "2026-01-13T16:47:06+03:00",
"operating_reset_at": 1768343826,
"operating": 0
}
}Возвращаемые данные
Названиетип | Описание |
|---|---|
resultarray | Массив с описанием полей папки. Структура описания каждого поля: |
IDinteger | Идентификатор папки |
NAMEstring | Имя папки |
TYPEenum | Тип объекта |
CODEstring | Символьный код папки |
STORAGE_IDinteger | Идентификатор хранилища, в котором находится папка |
REAL_OBJECT_IDinteger | Идентификатор объекта |
PARENT_IDinteger | Идентификатор родительской папки |
CREATE_TIMEdatetime | Дата и время создания папки |
UPDATE_TIMEdatetime | Дата и время последнего обновления папки |
DELETE_TIMEdatetime | Дата и время переноса папки в корзину |
CREATED_BYinteger | Идентификатор пользователя, создавшего папку |
UPDATED_BYinteger | Идентификатор пользователя, внесшего последнее изменение |
DELETED_BYinteger | Идентификатор пользователя, удалившего папку |
DELETED_TYPEenum | Статус удаления объекта |
timetime | Информация о времени выполнения запроса |
Обработка ошибок
- [](./disk-folder-add-subfolder)
- [](./disk-folder-copy-to)
- [](./disk-folder-delete-tree)
- [](./disk-folder-get-children)
- [](./disk-folder-get-external-link)
- [](./disk-folder-get)
- [](./disk-folder-mark-deleted)
- [](./disk-folder-move-to)
- [](./disk-folder-rename)
- [](./disk-folder-restore)
- [](./disk-folder-upload-file)
💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Получить описание полей папки disk.folder.getfields» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru