3. Описание MCP-сервера › 3.3 Движок › Картинки › engine_image_add

Закачивает файл в папку картинок группы шаблонов: картинку, шрифт, значок. Закачка по занятому пути заменяет файл.

Право

«Прямой доступ → Разработка → Изменение данных» (AGENT_ENGINE_DEV_WRITE).

Параметры

Параметр Тип Что это
path строка путь файла на сервере целиком, папка и имя: templates/default/images/logo.png
[content_source] строка файл на этом компьютере — абсолютный путь или путь от папки магазина. Уходит байт в байт
[content] строка тело файла текстом — для текстовых форматов вроде svg — вместо content_source
[overwrite] да/нет заменить файл, который уже есть по этому пути

Нужен content_source или content. Папка должна уже быть — её создаёт engine_image_dir_add.

overwrite нужен, чтобы заменить существующий файл. У файлов картинок нет версий, и заменённый файл не вернуть, поэтому закачка на занятый путь без overwrite=true отказывает.

Размер запроса ограничен сервером магазина: в стандартной установке это 64 МБ. Запрос больше отбивает сам сервер, и приходит отказ The server of the store refused the request as too large (HTTP 413)….

Ответ

{"path": "./../templates/default/images/logo.png", "bytes": 5430, "replaced": false}
Поле Что это
path путь файла на сервере
bytes сколько закачано
replaced заменён ли файл, который уже был

Отказы

Ответ Когда
… already exists, and uploading would overwrite it for good… файл по этому пути уже есть, а overwrite=true не указан
Give content_source - a path on this machine - or content… не указаны ни content_source, ни content
No such file: <путь> файла, названного в content_source, нет на этом компьютере
No such folder in the images tree: … engine_map_tree lists the folders under dirs. папки нет среди папок картинок
… is not a folder of the images tree. путь лежит вне папки картинок группы
The last part of path must be a plain file name. имя файла содержит ..
path is required… не указан path

Общие отказы — «Ответы и отказы».