Загрузка изображений
Прикрепление изображений к конкретным сущностям (товарам, категориям и т.д.) происходит в два этапа: сначала загружается сам файл, а затем, при создании сущности, указывается 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
содержит информацию об адресе изображения, типе, а так же его размерах. Вы можете
использовать эти значения для предотвращения скачков интерфейса из-за незагруженных изображений.