Загрузка изображений


Прикрепление изображений к конкретным сущностям (товарам, категориям и т.д.) происходит в два этапа: сначала загружается сам файл, а затем, при создании сущности, указывается ID загруженного файла.

Если сущность уже существует, то прикрепление изображения может выполняться в один шаг (загрузка с указанием владельца).

Загрузка изображения

Мы поддерживаем загрузку изображений в форматах JPEG и PNG. Для загрузки изображения необходимо выполнить POST-запрос на URL https://api.zenky.io/v2/media. Файл изображения необходимо передавать в поле file. Размер изображения не должен превышать 12 мегабайт.

В ответ на успешную загрузку будет предоставлен объект загруженного файла с идентификатором и краткой информацией. Этот идентификатор затем нужно будет использовать при прикреплении изображения к нужной сущности.

Для прикрепления изображения нужно обновить сущность с указанием ID изображения в соотв. поле (например, для изменения логотипа магазина нужно предоставить ID нового изображения в поле logo_image_id).

Названия полей смотрите в документации конкретных ресурсов.

Загрузка изображения с владельцем

Несмотря на то, что предыдущий способ так же можно использовать для уже существующих сущностей, изображения можно обновить одним запросом.

Для этого нужно указать дополнительные параметры owner_type, owner_id и collection. Параметр owner_type определяет тип владельца изображения (товар, категория и т.д.), owner_id — ID владельца, collection — коллекцию изображений, в которую нужно поместить новое изображение.

Ниже перечислены возможные значения параметра owner_type.

Коллекции

У каждого ресурса имеется список уникальных коллекций, в которые можно загружать изображения. Ниже перечислен список таких коллекций.

Пользователь

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

Магазин

В коллекцию store-logos загружаются логотипы магазина. Имейте в виду, что в эту коллекцию можно поместить только одно изображение. После обновления изображения предыдущее будет удалено без возможности восстановления.

Склад

В коллекцию stock_images загружаются изображения склада. Эта коллекция поддерживает неограниченное количество изображений.

Товар

В коллекцию product-images загружаются изображения товаров. Эта коллекция поддерживает неограниченное количество изображений.

Категория

В коллекцию category-covers загружаются обложки категорий. Имейте в виду, что в эту коллекцию можно поместить только одно изображение. После обновления изображения предыдущее будет удалено без возможности восстановления.

Коллекции товаров

В коллекцию products-collection-covers загружаются обложки коллекций товаров. Имейте в виду, что в эту коллекцию можно поместить только одно изображение. После обновления изображения предыдущее будет удалено без возможности восстановления.

Каналы продаж

В коллекцию website_images загружаются изображения конструктора веб-сайтов. Эта коллекция поддерживает неограниченное количество изображений.

Предложение

В коллекцию offer-covers загружаются обложки предложений. Имейте в виду, что в эту коллекцию можно поместить только одно изображение. После обновления изображения предыдущее будет удалено без возможности восстановления.

Статья

В коллекцию article-covers загружаются обложки статей. Имейте в виду, что в эту коллекцию можно поместить только одно изображение. После обновления изображения предыдущее будет удалено без возможности восстановления.

Изображение

После сохранения и обработки изображений, они будут выданы в ответах API (если были запрошены) в следующем формате:

Размеры изображений

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