метод REST scope: lists

lists.element.get.file.url

Получить путь к файлу

Кто может выполнять: пользователь с правом «Чтение» для нужного списка

Описание

Метод lists.element.get.file.url возвращает путь к файлу.

Параметры

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

Идентификатор типа инфоблока.

Стандартные типы:
- lists — универсальные списки
- bitrix_processes — процессы
- lists_socnet — списки групп

В коробочной версии можно также указать идентификатор произвольного существующего типа инфоблоков. IBLOCK_ID или IBLOCK_CODE должен указывать на инфоблок этого типа. Доступ к операции определяется стандартными правами пользователя на инфоблок, раздел или элемент

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

Идентификатор инфоблока.

Идентификатор можно получить с помощью метода lists.get

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

Cимвольный код инфоблока.

Код можно получить с помощью метода lists.get

Необходимо указать хотя бы один из параметров: IBLOCK_ID или IBLOCK_CODE

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

Идентификатор элемента.

Идентификатор можно получить с помощью метода lists.element.get

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

Символьный код элемента.

Код можно получить с помощью метода lists.element.get

Необходимо указать хотя бы один из параметров: ELEMENT_ID или ELEMENT_CODE

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

Идентификатор свойства Файл или Файл (Диск), без префикса PROPERTY_

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"IBLOCK_TYPE_ID":"lists","IBLOCK_ID":37,"ELEMENT_ID":231,"FIELD_ID":423}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/lists.element.get.file.url

Ответ

HTTP-статус: 200

{
    "result": ["/bitrix/tools/disk/uf.php?attachedId=103&action=download&ncc=1"],
    "time": {
        "start": 1763660762,
        "finish": 1763660762.617248,
        "duration": 0.6172480583190918,
        "processing": 0,
        "date_start": "2025-11-19T16:46:02+03:00",
        "date_finish": "2025-11-19T16:46:02+03:00",
        "operating_reset_at": 1763661362,
        "operating": 0
    }
}

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

result array

Массив ссылок для скачивания файлов.

Пустой массив означает, что в указанном свойстве нет файлов

time time

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

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

HTTP-статус: 400

{
    "error":"ERROR_REQUIRED_PARAMETERS_MISSING",
    "error_description":"Required parameter is missing"
}
Код Описание Значение
ERROR_REQUIRED_PARAMETERS_MISSING Required parameter X is missing Обязательный параметр не передан
ERROR_IBLOCK_NOT_FOUND Iblock not found Инфоблок не найден
ERROR_ELEMENT_NOT_FOUND Element not found Элемент с таким ID/CODE не найден
ACCESS_DENIED Access denied Недостаточно прав для чтения элемента

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

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