метод REST scope: landing

landing.block.uploadfile

Загрузить и привязать изображение к блоку

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

Описание

Метод landing.block.uploadfile загружает изображение и привязывает его к указанному блоку.

В ответе метод возвращает идентификатор файла и ссылку на него в поле src. Само изображение метод в блок не подставляет. Это значит, что после загрузки файл уже есть, но в содержимом блока он еще не показан. Обычно для этого после landing.block.uploadfile вызывают landing.block.updatenodes.

Параметры

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

Внутренний скоуп лендингов. Он не связан с REST-скоупом landing в названии метода.

Значение scope должно соответствовать типу сайта (подробное описание)

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

Идентификатор блока, к которому нужно привязать изображение.

Метод принимает идентификатор любого существующего блока.

Идентификатор блока можно получить методом landing.block.getlist

Если изображение нужно добавить в черновик опубликованной страницы, используйте идентификатор блока из черновика. Обычно для этого вызывают landing.block.getlist с параметром params.edit_mode = 1

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

Изображение для загрузки.

Метод принимает только изображения. Поддерживаются два формата:

  • URL изображения,
  • массив ["имя_файла.png", "base64_контент"].

Для массива имя файла должно содержать расширение. Во втором элементе массива передавайте только содержимое Base64 без префикса data:image/...;base64,.

При сохранении имя файла может измениться. Кириллические буквы метод транслитерирует, а пробелы и круглые скобки заменяет на _.

Подробнее о подготовке Base64: Как загрузить файлы

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

Расширение файла для загрузки по URL, если его нельзя точно определить по адресу.

Параметр учитывается только для picture, переданного как URL. Укажите в нем расширение файла изображения.

Если параметр не передан, расширение определяется автоматически. Для массива picture расширение берется из имени файла

params object необязательный

Дополнительные параметры обработки изображения (подробное описание).

Если параметр не передан, изображение сохраняется без изменения размера

temp boolean необязательный

Если значение приводится к true, файл помечается как временный.

По умолчанию — false

Параметр params

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

Целевая ширина изображения в пикселях.

Изменение размера выполняется только если одновременно передан height

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

Целевая высота изображения в пикселях.

Изменение размера выполняется только если одновременно передан width

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

Режим изменения размера.

Возможные значения:
0 — вписать изображение в указанные размеры с сохранением пропорций,
1 — изменить размер пропорционально по большей стороне,
2 — привести изображение к точным размерам, при необходимости обрезав его.

По умолчанию — 1. Параметр применяется только к растровым изображениям

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "block": 39556,
    "picture": ["banner.png", "**base64_image_content**"],
    "params": {
      "width": 1200,
      "height": 675
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.block.uploadfile.json"

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 33873,
        "src": "https://cdn-ru.bitrix24.ru/b13743910/landing/fda/fda6c41d4b2b4f4d672601bd48c6aff1/nature.jpg"
    },
    "time": {
        "start": 1774523909,
        "finish": 1774523910.101491,
        "duration": 1.1014909744262695,
        "processing": 1,
        "date_start": "2026-03-26T14:18:29+03:00",
        "date_finish": "2026-03-26T14:18:30+03:00",
        "operating_reset_at": 1774524509,
        "operating": 0.30655694007873535
    }
}

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

result object

Данные загруженного файла (подробное описание)

time time

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

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

HTTP-статус: 400

{
    "error": "FILE_ERROR",
    "error_description": "Ошибка загрузки файла. Возможно, файл не является графическим."
}
Код Описание Значение
MISSING_PARAMS Не передан обязательный параметр block или picture
BLOCK_NOT_FOUND Блок с идентификатором block не найден или недоступен. Ошибка также возвращается, если по этому идентификатору нельзя определить страницу
FILE_ERROR Не удалось загрузить изображение. Ошибка возвращается, если файл не скачался по URL, не прочитался из Base64, не прошел проверку как изображение, SVG не разрешен на портале или файл не удалось сохранить

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

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